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CHAPTER 1 

RDOS DRIVER IMPLEMENTATION 

INTRODUCTION 

In all real time computer control systems, the CPU reacts to input data from a real 
world environment and provides output data to correct or control the environment. 
The incoming data is normally the result of a process device interrupt or an input - 
output operation completion interrupt. In general these interrupts differ from one 
another only in the way in which they are serviced. 

When a significant event occurs, a signal is transmitted to the computer as an 
interrupt requiring a special subroutine to take appropriate action. Interrupts are 
usually assigned in order of urgency or priority, so that if two interrupts occur at 
the same moment, the more important interrupt is serviced first by the computer. 

How well a computer is able to respond to interrupts generally determines the max- 
imum capability of the real time system. A significant element in the responsive 
ability of any real time system is the inclusion of a powerful and flexible multi- 
priority interrupt control program. 

This document outlines the methods of adding customer -assignable multi -priority 
servicing routines. These device drivers can be included as part of the resident 
RDOS operating system or they can be implemented as part of the user application 
program and attached to the interrupt dispatch program. 

Statements in this manual which refer to RDOS can, unless otherwise qualified, be 
understood to apply to both mapped and unmapped versions of the operating system 
running in either NOVA® * or ECLIPSE^"^ ** computer environments. 

CHARACTERISTICS OF INTERRUPTS 

Interrupts can be generated by conditions internal to the computer hardware itself 
(power monitor option), or by events which originate in the plant or the environ- 
ment that is being controlled (an external hardware interrupt like an analog -to - 
digital converter completion). 



*NOVA is a registered trademark of Data General Corporation, Southboro, Mas- 
sachusetts. 
**ECLIPSE is a trademark of Data General Corporation, Southboro, Massachusetts. 



1-1 



Licensed Material - Property of Data General Corporation 

CHARACTERISTICS OF INTERRUPTS (Continued) 

Non-process interrupts may be caused by an error condition being detected, an 
interval timer run-down, an input -output (I/O) complete interrupt, etc. The I/O 
interrupt is characterized by the completion of an I/O device operation such as 
a paper tape or disk storage transfer function, which may involve the reading or 
writing of one character or word in the case of program control or multiple words 
in the case of data channel operation. The concept of this type of interrupt is based 
on the importance of keeping I/O devices active, thus improving job throughput. 

Process interrupts reflect process conditions which have been detected and which 
require an immediate change in program execution, such as may be caused by the 
closing of an electrical switch or contact, a rise In temperature above a pre- 
scribed limit, etc. 

INTERRUPT PRIORITY SCHEME 

There are several ways in which priorities are determined for or assigned to 
devices on the 1/0 bus. An elementary priority is established by the hardware 
for devices that are requesting interrupts simultaneously: among those devices 
waiting with an active interrupt, the one which is physically closest to the processor 
on the bus is at the highest priority. 

The most significant method is to specify which devices can interrupt a service 
routine currently in progress. This is done by using a 16 bit priority mask. Each 
device is wired to a particular bit of this mask word. 

By means of the mask word, the interrupt servicing program can inhibit specified 
levels of interrupts and thus establish any priority structure. The biggest ad- 
vantage of this means of priority level control is a near optimum priority response. 
To guarantee minimum response time to an interrupt, the mask bit assigned to 
this device should not be set for long periods of time. Through the judicious use 
of masking, data channels can be kept functioning for the transmission of data 
into and out of core storage while process interrupts are prevented from occurring. 
The function of masking is used to delay recognition of an interrupt (the important 
fact is that the interrupt is not lost). 



1-2 



Licensed Material - Property of Data General Corporation 
INTERRUPT PRIORITY SCHEME (Continued) 

The interrupt mask assignments for standard devices supplied by DGC are as 
follows: 



Mask 
3 

7 
17 



10 

217 

617 

717 

1717 

1737 

1777 



Assigned Devices 

$TTO, TTI, QTY (4060 quad multiplexer) 

$PTP 

$PLT, MCAT (4038 multiprocessor communications 
adapter transmitter), MCAR (4038 multiprocessor com- 
munications adapter receiver) 

$LPT 

$DP0, $DP1 (IPB dual processor full duplex link) 

moving head disk 

fixed head disk 

IPB half -duplex directory interlock 

$PTR 

$CDR, magnetic tape, cassette 



Although slower devices are assigned to higher numbered bits in the mask, there is 
no established priority, since the program can use any mask configuration. All 
devices which have their mask bits set will not cause an interrupt and are there- 
fore regarded by the program as being of lower priority. 
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INTERRUPT PRIORITY SCHEME (Continued) 

An example of multi -level priority interrupt servicing is shown below for an 
environment including a Teletype ® *, plotter and fixed head disk. 

Program Mask 

Fixed Head Disk Interrupt 717 



Plotter 13 

Teletype Interrupt 3 

Main Line User 

INTERRUPT DISPATCH PROGRAM 



At the precise moment an unmasked interrupt has been detected at the hardware 
level, the Interrupt Dispatch program (INTD) receives control to service the 
interrupt. The INTD program is assembled as an integral portion of the RDOS 
system and resides in core at all times. 

The INTD program is designed to do the following: 




•Identify the interrupting device** 
•Save the machine status and all** 
addressable registers 
•Set up the new priority mask*"* 



•Direct control to the proper servicing 
routine 

•Restore the previous priority mask ** 
•Restore the machine status and registers 
•Return to the interrupted program 



*Teletype is a registered trademark of Teletype Corporation, Skokie, Illinois. 
** This function is performed by the VCT instruction on ECLIPSE systems. 
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INTERRUPT DISPATCH PROGRAM (Continued) 

The INTO program directs control to the correct servicing routine by using the 
correct entry in the system Interrupt Branch Table (ITBL). ITBL is a 66 word 
table, with displacements corresponding to device codes 1-63. That is, device 
code 1 is found at displacement 1 (i.e., at "ITBL"). Each displacement corres- 
ponding to a device in the system contains the address of that device's DCT. AU 
other displacements contain -1. 
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User Program 



interrupt 




INTD 



ITBL 



INTD 




DCT 



DISMIS 







MASK 



INTS 



Interrupt 
Service 
Routine 



Flow of Control During Interrupts 
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DEVICE CONTROL TABLE (DCT) STRUCTURE 

Each device defined in the RDOS system must have the address of its DCT included 
in the interrupt branch table (ITBL) as explained in later sections. For interrupt 
servicing routines defined in the user's area, only the first three entries are 
needed. Words 7-26 of the DCT differ for byte and block oriented devices. 



WordO, DCTBS: 



In revisions prior to 04, this displacement continued the 
address of an eight word interrupt state save area not used 
by RDOS but reserved for compatibility with RTOS. In re- 
vision 04, bit zero is set to 1 if this device uses the data 
channel. 



Word 1, DCTMS: 



Mask Word. Clear a bit for every priority considered 
higher than the priority of this device. The devices cor- 
responding to the priority bits that are left cleared will be 
permitted to interrupt the current device. For a complete 
set of system mask words, see the list provided previously 
in INTERRUPT PRIORITY SCHEME. 



Word 2, DCTIS: 



Word 3, DCTCH: 



MNEMONIC 

DCCPO 

DCCGN 

DCIDI 

DCCNF 

DCTO 

DCKEY 

DCNAF 

DCRAT 

DCPCK 

DCLAC 

DCSPO 

DCFWD 

DCFFO 

DCLTU 

DCC80 

DCSPC 



Address of the device interrupt service routine. 

Device characteristic word. A list of device characteristics 
is given in the following table. 

BIT MEANING 

15 Device requiring leader/trailer 

14 Device requiring tab simulation 

13 Device requiring operator intervention 

12 Device requiring form feed simulation 

11 Teletype output device 

10 Keyboard input device (uncontrollable) 

9 Device requiring nulls after form feeds 

8 Device requiring rubouts after tabs 

7 Device requiring even parity check on input, 

even parity computation on output 

6 Device requiring line feeds after carriage returns 

5 Spoolable device (LPT, PTP, PLT, TTO) 

4 Full word device (any size greater than a byte). 

3 Form feed sent on .OPEN 

2 Convert lower to upper case ASCII 

1 Read 80 columns on input if set, 72 if reset. Send 

80 characters on output, 72 if reset. 

Spooling enabled if set to 1, disabled if reset 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 



Word 4, DCTCD: 



Word 5, DCTEX: 



Word 6, DCTDT: 



Device code. 

Address of variable I/O instruction routine (reserved but 
unused on ECLIPSE systems.) 

Address of the device command dispatch table; bit set 
implies disk device. One entry for every RDOS I/O function. 
The table order must correspond exactly to the order of the 
function given below. Each entry is an address to the routine 
implementing the named RDOS function. If the device does 
not permit a command, a-1 should be entered in place of 
the address. 



MNEMONIC 


DISPLACEMENT 


MEANING 


OF 





Open a file for reading/writing by one 
or more users. 


CF 


1 


Close a file. 


RS 


2 


Read Sequential 


RL 


3 


Read Line 


RR 


4 


Read Random 


WS 


5 


Write Sequential 


WL 


6 


Write Line 


WR 


7 


Write Random 


OA 


10 


Open a file for appending 


RO 


11 


Open for reading only 


EO 


12 


Exclusive read/write open 


TO 


13 


Transparent (exclusive) open (does not 
alter file access info) 



The following words, 7-26, are used with byte-oriented devices. 

Word 7, DCTST: Address of the device start routine. The device start 

routine specification is as follows: 



Word 10, DCTBC: 
Word 11, DCTBF: 
Word 12, DCTPC: 



Input device: Activate the device and return 
Output device: Character is passed in ACO 

Size of device buffer in bytes. 
Byte pointer to device buffer. 
Base level (program) byte count. 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 

Word 13, DCTPP: Base level (program) byte pointer. 

Word 14, DCTQL: Link to device request bead chain. 

Word 15, DCTDP: Device data byte pointer. 

Word 16, DCTDC: Device data count. 



Word 17, DCTQS: 
Word 20, DCTBD: 

Word 21, DCTQP 
Word 22, DCTTl 
Word 23, DCTT2 
Word 24, DCTTO 
Word 25, DCTCC 

(Word 25, DCTPR 
Word 26, DCTLC 

(Word 26, DCTLK 
Word 27, DCTON 
Word 30, DCTOF 
Word 31, DCTSL 
Word 32, DCTOP 
Word 33, DCTT3 



Bead status word (described in GENERALIZED I/O ROUTINES). 

Bead address (i. e. , the starting address of the first bead, 
word 14) 

Device queue starting address (initially -1). 

First temporary for device control. 

Second temporary for device control. 

Timeout constant for input devices. 

Output device column counter. 

Echo device DCT pair pointer, TTl only. ) 

Output device line counter. 

Link to TTR, TTI DCT s only. ) * 

"ON" DCB address for spooler. * 

"OFF" DCB address for spooler. * 

Link to next spoolable device DCT (-1 terminates the chain). 

Device queue starting address for operator messages. 

Temporary for operator message status word whose bits 
are defined as follows: 



*set by RDOS. 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 

Bit Meaning 

Set to 1 if "!" has been received. 
15 Set if "F" or "B" has been received. 

The following words, 7-26, are used with block transfer devices. 

Word 7, DCTRD: Read a Block. 



Word 10. DCNBl: 
Word 11, DCSTR: 
Word 12, DCDST: 

Word 13, DCCRQ: 
Word 14, DCTSZ: 
Word 15, DCTRL: 
Word 16, DCTRN: 
Word 17, DCTIN: 
Word 20, DCTRS: 
Word 21, DCNBK: 
Word 22, DCTNS: 
Word 23, DCTNH: 
Word 24, DCTMN: 



High order portion of number of blocks on the device. 

Device start routine. 

Set DST word (used for logical -to -physical disk block 
address computation). 

Current request pointer. 

Routine to perform disk sizing (not used by MTA/CAS). 

Read last block. 

Read next block. 

Device initialisation routine. 

Device release routine. 

Number of blocks on device (low order portion; see DCNBl). 

Number of sectors per track. 

Number of heads per unit. 

Hash frame size (one of the following); 

Moving Head Disk Type Frame Size (octal) 



4047 
4048 
4057 
4231 



103 
155 
255 
255 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 



Aggregate Fixed 
Head Storage 

128K 

256K 

384K 

512K 

640K 

768K 

896K 
1024K 
1152K 
1280K 
1480K 
1536K 
1664K 
1792K 
1920K 
2048K 



Frame Size (decimal) 

7 

13 

23 

31 

41 

47 

53 

61 

71 

79 

89 

97 
103 
113 
113 
127 



(For a description of hashing under RDOS, see 
the Stand Alone Disk Editor manual, 093-000092, 
Appendix B. ) 

Word 25, DCHMP: First slot in data chaimel map (mapped systems only). 

Word 26, DCHNM: Number of slots needed in data channel map (mapped 

systems only). 

USER FILE TABLE (UFT) STRUCTURE 

User File Tables (UFTs) are tables used by the operating system to record file and 
device information for each file or device that is opened. There is one UFT for 
each channel defined to be available to a user program (via the . COMM TASK state- 
ment or RLDR switch /C). These tables reside in system space in mapped environ- 
ments, and between NMAX and the operating system in unmapped single program 
environments (see Chapter 6 of the RIXDS Reference Manual for further information 
about the location of these tables). UFT structure is defined in PARU. A sub- 
section of each UFT, termed the UFD, is also defined in PARU; it consists of words 
0-21 of each UFT. The structure and mnemonic assignments of UFTs are as 
follows: 
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Words to 4, UFTFN: 
Word 5, UFTEX; 
Word 6, UFTAT; 
Word 7, UFTLK; 
Word 10, UFTBK 
Word 11, UFTBC: 
Word 12, UFTAD; 
Word 13, UFTAC 
Word 14, UFTYD: 
(Word 14, UFLAN, links 
Word 15, UFTHM 
Word 16, UFTPl: 
Word 17, UFTP2: 
Word 20, UFTUC 
Word 21, UFTDL: 
Word 22, UFTDC 
Word 23, UFTUN; 
Word 24, UFCAl; 
Word 25, UFTCA; 
Word 26, UFTCB; 
Word 27, UFTST; 



File name. 
File extension. 
File attributes. 
Link access attributes word. 
Number of the last block in the file (disk file). 
Number of bytes in last block (disk file). 
Device address of first block (disk file). 
Year /day last accessed. 
Year /day created, 
only: Link alias name. ) 
Hour /minute created. 
Temporary location used by the system. 
Temporary location used by the system. 
File use count. 
Link to DCT. 
DCT address. 
Unit number (disk file). 

Current block address high order (disk file). 
Current block address, low order (disk file). 
Current block number (disk file). 
File status: 







STER 


1B15 


ERROR DETECTED 






b"riOP 


IB 14 


I/O IN PROGRESS 






STFWR 


1B13 


FIRST WRITE FLAG 






STDIU 


1B12 


DIRECTORY IN USE 






STRWD 


1B09 


OPENED FOR MTA R/W BLOCK 






ST7T 


1B08 


7 TRACK MAG TAPE 






STINI 


1B01 


NO INFT FLAG 






STCMK 


1B!2I0 


SET = READ (BLKIO) 
INIT/RE LEASE BIT 






STOPN 


1B2 


DCB OPENED (MTA) 


Word 30, 


UFEAl: 


Entry's block addre> 


3S, high order (disk file). 


Word 31, 


UFTEA: 


Entry's block addre> 


3S, low order (disk file). 


Word 32, 


UFNAl: 


Next block address. 


high order (disk file). 


Word 33, 


UFTNA: 


Next block address. 


low order (disk file). 


Word 34, 


UFLAl: 


Last block address. 


high order (disk file). 


Word 35, 


UFTLA: 


Last block address. 


low order (disk file). 


Word 36, 


UFTDR: 


SYS.DR DCB address. 


Word 37, 


UFFAl: 


First address 


, high 


order, (disk file). 


Word 40, 


UFTFA: 


First address 


, low order, (disk file). 



Displacements in UFTs which refer to disk files are set to zero when the opened 
file described by the UFT is not a disk file. 
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CHAPTER 2 

OPERATING SYSTEM DEVICE IMPLEMENTATION 
GENERAL 

Device driver support can be provided by the operating system in one of two ways: 

1) by incorporating the driver into the operating system at 
source program level; 

2) by identifying the driver to the operating system at run time 
via system call , IDEF. 

The first of these means is the most efficient means of providing device interrupt 
service, since the same routines and data bases used by system devices are made 
available to the 'user device. This method requires a detailed understanding of 
system data bases, service routines, and device driver structure. These items 
are described in Chapters 1 and 2. 

The second method, described in Chapter 3, is somewhat less efficient since it 
entails a duplication of certain functions by the user which are already provided 
by the system. Nonetheless, this method is comparatively simple to use, and it 
can be applied to both character and data channel devices. 

The following is a list of I/O devices, their names and their device codes, that are 
standard system devices. 

Device Name Device Device 

Code 

$CDR card reader, primary controller 16 

$CDR1 card reader, secondary controller 56 

CTn DGC cassette unit n, primary controller 34 

CTln DGC cassette unit n, secondary controller 74 

DKO DGC NOVADISC, primary controller 20 

DKl DGC NOVADISC, secondary controller 60 

Dfti moving head disk, n = -3; primary controller 33 

Dfti moving head disk, n = 4 -7; secondary controller 73 

$DPI input dual processor link 40 

$DPO output dual processor link 41 

$LPr line printer 17 

$LPri second line printer 57 

MCAR first multiprocessor communications adapter 

receiver 7 

MCARl second multiprocessor communications adapter 

receiver 47 
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Device Name 

MCAT 

MCATl 

MTn 

MTln 

$PLT 

$PLT1 

$PTP 

$PTP1 

$PTR 

$PTR1 

QTY 

RTC 

$TTR/$TTI 

$TTR1/$TTI1 

$TTP/$TTO 
$TTP1/$TT01 



Device Device 

Code 
first multiprocessor communications adapter 

transmitter 6 
second multiprocessor communications adapter 

transmitter 46 

magnetic tape unit n, primary controller 22 

magnetic tape unit n, secondary controller 62 

incremental plotter 15 

second incremental plotter 55 

high speed paper tape punch 13 

second high speed paper tape punch 53 

high speed paper tape reader 12 

second high speed paper tape reader 52 

type 4060 asynchronous data multiplexor 30 

real time clock 14 
Teletype reader /keyboard or display terminal 

keyboard 10 
second Teletype reader Aeyboard or display 

terminal keyboard 50 

Teletype printer /punch or terminal screen 11 
second Teletype printer/punch or terminal screen 51 



Device code 2 is not available to mapped RDOS (MRDOS) user devices, and device 
codes 14 and 36 are not available for use by any user devices selected to run under 
RDOS or MRDOS. 

Changes to RDOS to incorporate another device into the operating system can be 
made at the source program level. This section describes briefly the required 
changes to add a device. However, to completely understand the process of adding 
a device driver, the user may need to review listings of those RDOS programs 
mentioned later that require modification. The source programs required are 
available from DGC. 

During full initialization of the system, names of all single -file peripheral devices 
in the system are added to the system file directory, SYS. DR. The device name 
will be entered only if the user has forced the driver to be loaded. 
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The general procedure for adding a device driver at source level is as follows: 

. declare a DCT entry for the device 

. enable entry of the device name in SYS. DR 

. update the system library 

. create a system queue entry 

. perform a system generation and load. 

The following sections describe each of these steps. 

REENTRANT CODING AND SUBROUTINE LINKAGE 

One of the basic problems that arises in multilevel priority interrupt programming 
is that different levels require use of the same subroutine. This means that a 
higher priority interrupt could interrupt a lower priority one before it has com- 
pletely used a common subroutine and argument pointers, temporary core storage 
locations, etc. , with the result that the return point for the lower level interrupt 
would be lost. Reentrancy, then, is defined as that property of a subroutine where- 
by use of the routine does not modify any of its locations; temporary values are 
stored outside the routine. Thus one user may be prevented temporarily from 
completing use of a reentrant routine because a higher priority user needs to use it. 
When the higher priority user has finished with the routine, the lower priority user 
completes his use of the routine at the point where he was interrupted. 

A method of reentrant coding using a system stack has been devised for RDOS to 
allow one subroutine to be entered at any time and from any interrupt level without 
loss of results. The operating system has several stacks used for the saving of 
state variables whenever a call to a system subroutine is executed. The structure 
of NOVA RDOS stacks and stack frame differs from those employed on ECLIPSE 
systems. On NOVA systems, each of these stacks is of a fixed length and stack 
frames are defined in the same manner for each stack. The stack frame is the 
basic increment of storage on a system stack. 
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REENTRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Each NOVA system stack consists of 10 octal frames, each stack frame is 16 octal 
locations in length, and the locations in each frame have the following definitions: 



Displacement 
-1 


1 

2 

3 

4 



Mnemonic Contents 

SP Pointer to the beginning of this stack frame 

(i.e., to RTLOC) 
RTLOC Return location. 

ACO AGO contents if this routine calls another 

routine. 
ACl ACl contents if this routine calls another 

routine. 
AC2 AC2 contents if this routine calls another 

routine. 
TMP First general purpose storage location for 

use by this routine. 



13 
14 



MXTMP Eighth and last general purpose storage 

location. 
VRTN Overlay virtual address if the caller is a 

system overlay. 
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REENTRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Thus if system subroutine A called system subroutine B, a portion of the system 
stack would contain the following items: 





A's return PC 


1 


RTLOC 


" calls "B" 


! A's accumulators 


ACn 


: A's temporaries 


TMP 


' 




MXTMP 




A's virtual address 




VRTN 


CSP — ^ 


1 


i 








RTLOC 








AC2 






TMP 




B's temporaries 










MXTMP 



B's virtual address VRTN 



NOVA RDOS Stack Segment 

Notice that B's return and AC displacements would not be used until and unless B 
calls out to another routine. Furthermore, A's AC storage and return storage 
locations are known to B as OAQi and ORTN, and can be used by B , should B 

wish to return AC parameters to A. Consult PARS for a complete list of system 
stack mnemonic definitions. 

RDOS maintains a pointer for the current system stack frame in location 10, CSP. 
Linkage to save subroutine state variables on a system stack and restore these 
variables is provided by routines contained in a utility package called GSUB (MGSUB/ 
AGSUB/BGSUB). The save/restore routines are entitled SAV, SRTN, and RTN. 



2-5 



Licensed Material - Property of Data General Corporation 

REENTRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Calls to these routines are defined in the system parameters as RSAVE, SRTRN and 
RTRN. 



On ECLIPSE systems, the RTN machine language instruction is used for system 
stack frame popping; a macro, RSAVE, is defined using instruction SAVE for 
stack pushing. This permits stack frames to be variable in length and speeds up 
the use of the stack. The current frame pointer, CSP, is maintained in location 41. 
Each system stack in a ECLIPSE environment is 250 octal words long; the interrupt 
stack is only 100 octal words in length. The fixed portion of each ECLIPSE system 
stack frame is defined as follows: 



Displacement 
-4 

-3 

-2 

-1 


1 
2 



Mnemonic Contents 

OACO ACO contents if this routine calls another 

routine. 
OACl ACl contents if this routine calls another 

routine. 
OAC2 AC2 contents if this routine calls another 

routine. 
OSP Current stack pointer (CSP) for this frame 

if this routine calls another routine. 
ORTN PC contents if this routine calls another 

routine. 
OVRTN Overlay virtual address if the caller is a 

system overlay. 
TMP First temporary storage location of the called 

routine (if this routine calls out). 

Additional variable storage of called routine. 
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REENTRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Thus if system subroutine A called system subroutine B, a portion of the system 
stack would contain the following items: 



"A"caUs "B" CSP 



A's accumulators 



A's CSP 



A's return PC 



A's virtual address 




OACn 

OSP 

ORTN 

OVRTN 

TMP 



ECLIPSE RDOS Stack Segment 

GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB, BGSUB, AGSUB) 

GSUB (MGSUB, BGSUB, AGSUB) is a core resident module which contains a series of 
utilities for the system's use; GSUB is used by NOVA RDOS, MGSUB is used by 
NOVA mapped RDOS (MRDOS), BGSUB is used by unmapped ECLIPSE RDOS, and 
AGSUB is used by mapped ECLIPSE RDOS. These utilities can be called by user- 
routines and are used extensively by the system in such areas as device drivers 
(e.g. , card reader) and overlays (e.g., RINGl and RING2). Each of these utilities 
is self-contained, i.e. , none of them calls out to other routines and none of them 
save variables outside a system stack frame (except the byte -handling and compare - 
word routines, as noted later). The following list gives the entry names and uses 
of each of the utilities in the GSUB, MGSUB, BGSUB, AGSUB modules. 

The column labeled "CPU" describes the type of computer system which can issue 
this call. When a call is appropriate to a mapped environment (e.g., MVMFW) 
yet is listed as being issuable in a non-mapped system, that call is equated with a 
similar call (e.g. , MVWD) which is appropriate in an unmapped environment. This 
permits certain calls like MVMFW to be issued in both environments. 
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GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB, BGSUB, AGSUB) (Continued) 
CPU types and their keys are as follows: 

1 - Unmapped NOVA computer. 

2 - Mapped NOVA computer. 

3 - Unmapped ECLIPSE computer. 

4 - Mapped ECLIPSE computer. 
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NAME 



CPU 



RSAVE 


1.2 


RETN 


1.2 


MVBYT 


1.2,3,4 


MTMVB 


1,3 


MFMVB 


1.3 


LDBT 


1.2 


LDCHR 


1,2 


STBT 


1.2 


STCHR 


1.2 


MLDBT 


1.2.4 


MSTBT 


1.2.4 


MVWD 


1.2.3.4 


MBMVW 


1.2.3.4 


MFMVW 


1.2.3,4 


MTMVW 


1.2.3.4 


CLEAR 


1.2,3.4 


MCLR 


1,2.3.4 


CMPWD 


1.2.3.4 


DIVI 


1.2.3.4 


DIVD 


1.2.3,4 


MPY 


1.2,3,4 


MPYAD 


1,2,3,4 


ROX 


1,2 


SETFL 


1,2 


RSTFL 


1.2 


SRTN 


1.2 


MBLK 


2.4 


SSOVF 


3,4 



USE 



Save state variables on a system stack. 

Restore state variables, return the frame to the system stack. 

Move a bjrte string. 

Move bytes with a mapped to address. 

Move bytes with a mapped from address. 

Load a byte. 

Load a byte. 

Store a byte. 

Store a byte. 

Load a byte. 

Store a byte. 

Move a word string. 

Move words with both addresses mapped. 

Move words with a mapped from address. 

Move words with a mapped to address. 

Set a block of core to all zeroes. 

Clear a block of words with a mapped starting address. 

Compare two word strings. 

Perform single precision integer divide. 

Perform double precision integer divide. 

Perform single precision integer multiply. 

Perform double precision integer multiply. 

Perform an exclusive or. 

Set bits in a word to one. 

Reset bits in a word to zero. 

Restore current state variables and do not return a frame 

to the system stack; return to the immediate caller (not to 

the address stored in RTLOC). 

Convert a user address to a mapped address. 

Stack overflow handler. 



List of General Subroutines 



2-9 



Licensed Material - Property of Data General Corporation 
GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB, BGSUB. AGSUB) (Continued) 

Except for RSAVE, RETN and SRTN, each of these routines is called by means of 
an indirect call to a pointer within the calling routine containing the routine name, 
e.g. , a call to ROX would be performed in the following manner: 

. EXTN ROX 

JSR @. ROX 



.ROX: ROX 

RSAVE, RETN and SRTN are used frequently in the operating system routines, so 
their entry points have been stored in the RDOS page zero area at locations 3, 4, 
and 11 octal respectively. Calls to these routines are defined in the system param- 
eters (PARS or MPARS) as follows: 

RSAVE is a macro call defined in PARS for NOVA systems to the save subroutine 
whose address is stored in location 3: 

. MACRO RSAVE 

STA 3, @CSP 

JSR @. SAV 

% 

For ECLIPSE systems, the RSAVE macro is defined as follows: 

. MACRO RSAVE 
SAVE 
t 1 + 1 



RETN = JSR @4 
SRTRN = JSR @11 

Use of these mnemonics is sufficient to invoke the routine. 

The following summarizes the inputs required by each General Subroutine Package 
routine and describes the outputs obtained upon return from each call. These 
routines are used extensively by the system; for example, the card reader driver 
uses CMPWD and RINGl (discussed in a following section) uses LDBT. Each routine's 
description (except RSAVE, RETN, and SRTN) presumes the existence of a pointer 
containing the routine name as illustrated above. 
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Load /Store a Byte (Continued) 

Output: they are not reentrant. 

Exclusive Or 



Input: 

Calling Sequence: 
Output: 

Clear a Block of Cor e 
Input: 

Calling Sequence: 
Output: 

Move a Word String 
Input: 

Calling Sequence: 
Output: 



ACl, First operand 
ACO, Second operand 

JSR@ .ROX 

The exclusive OR of the input operands is returned in ACl. 
Both ACO and AC2 are restored to their input values. 



ACO, Number of sequential words to be cleared to zeroes 
AC2, Starting (lowest) address of the block. 

JSR @ . CLEAR 

The specified block of core is cleared. ACO through AC2 
are restored upon exit. 



ACO, Starting address of the string to be copied 
ACl, Starting address to receive the string copy 
AC2, Number of words to be copied 

JSR @ . MVWD 

The specified word string is copied to the specified receiving 
core area. ACO through AC2 are restored to their input 
values. 



Compare Two Word Strings 



Input: 



Calling Sequence: 



ACO, Starting address of the first string 
ACl, Starting address of the second string 
AC2, Number of Words to be compared 

JSR @ . CMPWD 
success return 
failure return 
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Mapped Move a B3rte String (Continued) 



Calling 
Sequence: 

2) Input: 



Calling 
Sequence: 



JSR @ . MFMVB 

AGO, "From" byte pointer 
ACl, Mapped "to" byte pointer 
AC2, Byte count. 



JSR @ . MTMVB 



Mapped Lxjad and Store Bytes 

There are two load/store byte routines for mapped systems; each routine accepts 
mapped byte pointer inputs only. The result accomplished by both routines is 
identical: the byte is loaded or stored where the mapped byte pointer specifies 
that it should be accomplished. Neither of these routines is reentrant. 

The formats of the two routines are as follows: 



1) Input: 



Calling 
Sequence: 

2) Input: 

Calling 
Sequence: 

Output: 



ACl, Mapped byte pointer 

ACO, Byte to be stored (right adjusted) 



JSR @ . MSTBT 

ACl, Mapped byte pointer 

JSR @ . MLDBT 

ACO, Byte (right adjusted) 



Mapped Move a Word String 

There are three move word string routines for mapped systems. One routine accepts 
a mapped "to" address, another routine accepts a mapped "from" address, while 
the third accepts both a mapped "to" address and a mapped "from" address. The 
result accomplished by all three routines is identical: the specified word string 
is copied to the specified receiving core area. ACO through AC2 are restored to 
their input values. 
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Mapped Clear a Block of Core (Continued) 

the following section. 

GENERALIZED 1/0 ROUTINES 

The 1/0 modtoles (RINGl, R1NG2, and RING3) provide a number of useful, general- 
purpose reentrant routines for handling byte I/O from any device, on input or 
output, using the program interrupt facility. Entry names of the appropriate 1/0 
routines are placed in each device driver dispatch table as required (see Device 
Control Table Structure, word 6). Each 1/0 module is a system overlay. 

The basic buffer philosophy is to maintain one or more fixed length buffers, with 
pointers and counters maintained to indicate the amount of data in the buffers and 
the current word input or output. A virtually unlimited nun±ier of buffers can be 
appended to the first buffer, with a four-word bead assigned to maintain status 
information and pointers for each additional buffer. 

An input device inputs to the buffer at interrupt time and outputs from the buffer 
at program base level. An output device inputs to the buffer at program base 
level and outputs from the buffer at interrupt time. 



OBUF 



IBUF 



interrupt 
level DP- 



r 



DC 



V 



PP 

^^*- program 

~^ level 



) PC 



y 



PC ^ 
program 
level 

PP 

1 


r 









) 



DP interrupt 

level 
DC 



Input Devices 



Output Devices 
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GENERALIZED I/O ROUTINES (Continued) 



Bit 

1B7 
1B8 
1B9 

1B12 
1B13 
1B14 
1B15 



Meaning 

Device opened to the background 

Device opened to the foreground 

Common service routines should not start this device (e.g. 

$CDR) 

Treat this buffer as a ring buffer when it becomes filled 

Buffer is being treated as a ring buffer 

Echo the character (TTI only) 

Request is completed (cleared by ENQUE routine) 



DCT 




-1 



DPn 



DCn 



STATUS 



y^ 



/-' 



DCo 



V. 



DC 
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GENERALIZED I/O ROUTINES (Continued) 

opened), then control would be dispatched through DCTDT and thence through dis- 
placement CF of the dispatch table. The name of the routine used by $PTR to close 
this device is CLSl; this name is found in displacement CR of $PTR's dispatch table. 

If the routines provided by the I/O modules are not adequate for a user application, 
the user writing the device driver must write his own I/O routines (preferably 
making them core -resident), and insert their names into his driver's dispatch 
table at the appropriate displacements. 

Whenever control is given to a routine whose name is in the dispatch table, 
the system provides the following well-defined input parameters: 

AGO - As passed by user in . SYSTM call 
ACl - As passed by user in . SYSTM call 

AG2 - Address of the UFT corresponding to the channel number 
supplied in the . SYSTM call 

The UFT is a table which, you will recall, is described in Ghapter 1. The UFT is 
defined in PARU, and it is a table which describes each file or device that is 
currently open. 

User-written routines may either do some preprocessing of inputs received at the 
dispatch table and then transfer control to one of the I/O routines, or the user- 
written routine may perform all the processing of these inputs. Preprocessing of 
inputs provided by system calls to OPEN or GLOSE a file/device are not allowed. 

Open (OPNO, OPNI) 

OPNO is used to open output devices, while OPNI is used to open input devices. 
OPNI issues an operator intervention message (if required), while OPNO issues 
the message, provides a form feed, and outputs leader if required. Both routines 
clear a device and initialize its DGT. This implies that the DGT has provided all 
necessary 1/0 buffer information as well as the seven words of variable storage 
(words 12-16 and 22-23 of the DCT.) 

hiput: AG2 - UFT address 

Galling Sequences: 1) Insert OPNO (OPNI) mnemonic into device dispatch 

table at displacement 0, OF. (Input is provided by 
the system. ) 
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Open(OPNO, OPNI) (Continued) 

Calling Sequences: 2) .EXTN OPNO (OPNI), OV LAY 
(Continued) JSR @ .OVLY 

OPNO (OPNI) 

error return (never taken) 

normal return 

.OVLY:OVLA.Y 

Users may do no preprocessing of inputs to OPNO (OPNI). If a user wishes to provide 
a special open routine for a device, the system OPNO (OPNI) routine cannot also be 
called for that device. 

Close (CLSO, CLSI) 

CLSO should be used only to close output devices. It waits until all output has settled, 
clears the column counter, clears the device, initializes the DCT, and provides 
trailer if required. Alternatively, CLSI should be used only to close input devices. 
It merely clears the device and initializes the DCT. 

Input : AC 2 - UFT address 

Calling Sequences: 1) Insert either mnemonic CLSO or CLSI into the device 

dispatch table at displacement 1 (CF). (Input is provided 
by system. ) 

2) .EXTN CLSO (CLSI), OVLAY 
JSR @ .OVLY 
CLSO (CLSI) 

error return (never taken) 
normal return 

.OVLY: OVLAY 

Users may do no preprocessing of inputs to CLSO (CLSI). If a user wishes to provide 
a special close routine for a device, the system close CLSO (or CLSI) routine may 
not also be called for that device. 

Read Sequential (RDS) 



The device will be read, one byte at a time, until the byte count requested is satisfied. 
The data is not modified in any manner; this command is used for binary transfers. 

Input: AC 2 - UFT address 

ACl - byte count for RDS 
ACO - destination byte pointer 
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Read Sequential (RDS) (Continued) 

Calling Sequences: 1) Insert RDS mnemonic into device dispatch table at dis- 
placement 2 (RS). (Input is provided by system.) 

2) . EXTN RDS, OVLAY 
JSR @ .OVLY 
RDS 

error return 
normal return 

. OVLY: OVLAY 

The error return is taken if an end of file or device timeout occurs, at which time 
error code EREOF is returned in AC2 and the partial byte count is returned at ACl. 
If the normal return is taken, the full byte coimt read is returned in ACl. 

Read Line (RDL) 

This routine is used to transmit ASCII data and terminate after transmission of a 
carriage return, form feed, or null. All bytes transmitted are masked to seven 
bits. Line feeds and rubouts are unconditionally ignored. 

hiput: AC2 - UFT address 

ACO - destination b3^e pointer 

Calling Sequence: 1) Insert RDL mnemonic into device dispatch table at displace- 
ment 3 (RL). (Input is provided by system. ) 

2) . EXTN RDL, OVLAY 

JSR@ . OVLY 
RDL 

error return 
normal return 



.OVLY: OVLAY 

The read byte count is returned in ACl, whether the error or normal returns are 
taken. The error return is taken and a system error code returned in AC2 for the 
following conditions: 
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Read Line (RDL ) (Continued) 

AC2 Mnemonic Meaning 

6 EREOF End of file or device timeout. 

22 ERLLI Line length exceeded 132 characters without 

a valid terminator. 
24 ERPAR Parity error in the last character transmitted. 

Write Sequential (WRS) 

Data is output in byte form to a device until the byte count has expired. The data 
is not altered in any manner. This mode is therefore the standard mode for 
binary output transfers. 

Input: AC2 - UFT address 

ACl - byte count for WRS 
AGO - source byte pointer 

Calling Sequences: 1) Insert mnemonic WRS into the device dispatch table at dis- 
placement 5 (WS). (Output is provided by the system.) 

2) .EXTN WRS, OVLAY 

JSR@ . OVLY 

WRS 

error return 
normal return 



.OVLY: OVLAY 

The byte count written is returned in ACl. The error return is never taken. 

Write a Line (WRL) 

This routine transmits ASCII data to the appropriate device and terminates after 
transmitting either a carriage return or a form feed. Termination also occurs 
upon detection of a null, but the null is not written. Checks are made of the device 
characteristics to determine whether to perform: 

1. Parity on output 

2. Nulls after form feeds 

3. Line feeds after carriage returns 

4. Tab simulation (every 8 columns) 

5. Rubouts after tabs 
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Write a Line (WRL) (Continued) 

Input: AC2 - UFT address 

AGO - source byte pointer 

Calling Sequences: 1) Insert WRL mnemonic into device dispatch table at dis- 
placement 6, WL. (Output is provided by the system. ) 

2) .EXTN WRL, OVLAY 

JSR@ . OVLY 

WRL 

error return 
normal return 

.OVLY: OVLAY 

The write byte count is return in ACl upon exit. Tlie error return is taken after 
132 bytes have been written without detection of a valid terminator, and AC2 
contains the following error code: 

AC2 Mnemonic Meaning 

22 ERLLI Line limit exceeded. 

The RING I/O modules do not provide for random record reading or writing. 

Get Master or Default Directory Name (GMDIR/GDIRS) 

These routines pass the name of the master directory device (GMDIR) or the name 
of the current directory (GDIRS). The master directory device is the primary or 
secondary partition which becomes the current directory after a full system initiali- 
zation or a bootstrap; this directory also contains the system overlays. Since 
several versions of the operating system may be available for bootstrapping, 
different devices may become the master device. If the name of the current direc- 
tory is requested, only the current directory name, not the colon delimiter and not 
the names of superior directories, is returned. The format of these calls is: 

Input: AGO - Byte pointer to 13 byte user area 

o 
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Get Master or Default Directory Name (GMDIR/GDIRS) (Continued) 

Calling Sequences: . EXTN OVLAY, GMDIR, GDIRS 

JSR @ . OVLAY 

GMDIR ;GET THE MASTER DIRECTORY NAME 

error return ;ATTEMPT TO OVERWRITE THE SYSTEM 

normal return 



JSR @ .OVLAY 
GDIRS 

error return 
normal return 



;GET THE CURRENT DIRECTORY NAME 
jATTEMPT TO OVERWRITE THE SYSTEM 



.OVLAY: OVLAY 
Two error codes may be returned: 
AC2 Mnemonic 



33 

74 



ERRD 
ERMPR 



I/O BUFFER MODULE (lOBUF) 



Meaning 

Attempt to overwrite system (unmapped only). 
Address outside address space (mapped only). 



lOBUF is a core -resident module used by nearly all system drivers. One use of 
lOBUF is to execute certain types of I/O instructions; this permits the writing of 
reentrant drivers used by multiple devices (e. g. , a multiple TTY system requiring 
only one TTY driver). Another use of lOBUF is to provide common input /output 
character device interrupt processing. lOBUF also provides routines to place a 
bead at the end of a bead string and to remove any bead from the string. Finally, 
lOBUF provides routines which perform common input and output character device 
interrupt servicing. 
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I/O BUFFER MODULE (lOBUF) (Continued) 

The following list summarizes the entries in lOBUF. Before any of these calls 
can be issued, interrupts must be disabled unless they are masked due to the call's 
being issued at interrupt level. 

Entry Use 

CISER Common input interrupt service. 

COSER Common output interrupt service. 

DEQUE Remove any bead from the string. 

ENQUE Add a bead at the end of the string. 

FINP Partial input interrupt service. 

IBUF Input a character to the I/O buffer. 

OBUF Output a character from the I/O buffer. 

PENQU Priority enqueue a bead. 

STOUT Initiate an output device, then provide intermpt service. 

XDIAC DIAC instruction processor. 

XDOAS DOAS instruction processor. 

XNIOC NIOC instruction processor. 

XNIOS NIOS instruction processor. 

XSKPB SKPBZ instruction processor. 

XDIAP DIAP instruction processor. 

XIBUF Priority enqueue a bead and input to buffer. 

Calls to any of the instruction processor entries (XDIAC, XDOAS, etc. ) cause that 
instruction to be built (for the specific device in question), stored in the driver's 
"execute I/O instruction" area (pointed to by DCTEX of the device's DCT), and 
executed. Control is then returned to the caller. Calls to the instruction proces- 
sors are issued solely by the system; specific call types depend upon the entries 
selected in the device dispatch table or in displacement DCTST of the Device 
Control Table. Upon return from any of these calls, the contents of ACS are un- 
defined. 

Common Input Device Interrupt Service (CISER ) 

CISER provides interrupt service for character input devices. CISER is called 
either by placing the mnemonic CISER in word 2 of the input device's DCT or by 
means of the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: . EXTN QSER 

JSR @ . CISE 
return to DISMIS 

. CISE: CISER 
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Common Input Device Interrupt Service (CISER) (Continued) 

Output: If the instruction execution returns a character, this character is 
returned in the device buffer. The input contents of ACl are lost; 
the input contents of AC2 are preserved. 

Common Output Device Interrupt Service (CQSER, STOUT ) 

COSER provides interrupt service for character output devices. STOUT initiates 
an output device, starts the device, then branches to COSER. Each routine can be 
called either by placing its mnemonic in word 2 (DCTIS) of the DCT or by means of 
the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: . EXTN COSER (STOUT) 

JSR@ .COSE 
return to DISMISS 

.COSE: COSER (STOUT) 

Output: If a character is available for output in the device buffer, it is 
output. AC2 is preserved upon exit. 

Add a Bead to the String (ENQUE) 

ENQUE attaches a bead and I/O buffer to the end of the string of beads and buffers. 
This new bead becomes the last bead in the string, and is given a LINK of -1. 
ENQUE is called by means of the following calling sequence: 

Input: 



ACl - 


Bead address 


AC2 - 


DCT address 


quence : 


.EXTN ENQUE 




JSR@ .ENQU 




return 


.ENQ: 


ENQUE 



Output: The bead and its associated buffer are attached to the end of the 
bead string. If the device is not busy, it is started. AC2 is 
unchanged upon exit. 

Terminate Bead from Head of List (DEQRQ) 

Like FINP, DEQRQ shares common code with CISER. DEQRQ' s operations, how- 
ever, are limited to the following: Sets "Request Done" in the bead status word, 
readies a system task if necessary, and determines if any other beads are enqueued 
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Terminate Bead from Head of List (DEQRQ) (Continued) 

for the device. If other beads are enqueued, updates the bead pointer in DCTQP 
and restarts the device; otherwise clears the device. 

Input: AC2 - DCT address 

Calling .EXTN DEQRQ 

Sequence: JSR @ .DEQRQ 

normal return 

. DEQRQ :DEQRQ 
Remove a Bead from the String (DEQUE) 

DEQUE removes a bead from the bead string by setting the bead status word to 
"inactive" and adjusting the adjoining bead links, and by clearing the device 
associated with this string if the device is no longer active. The DEQUE calling 
sequence is: 

Input: ACl - Address of the bead to be removed 
AC2 - DCT address 

Calling .EXTN DEQUE 
Sequence : JSR @ . DEQU 
return 

.DEQU: DEQUE 

Output: The bead is inactivated and removed from the string. AC2 is 
unchanged upon exit. 

Partial Input Interrupt Service (FINP) 

FINP performs all functions accomplished by CISER without initially issuing a call 
to XDIAC followed by a restart of the device; FINP is thus an entry in CISER code 
which omits those two functions. FINP presumes that these functions have been 
performed elsewhere (as in the TTY and CDR drivers). 

Input: AC2 - DCT address 

Calling .EXTN FINP 
Sequence: JSR @ FINP 

normal return 

. FINP: FINP 
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Input a Character to the I/O Buffer (IBUF) 

IBUF places an eight -bit character in the currently available buffer slot. All book- 
keeping in the DCT is maintained. 

Input: AGO - character (left byte ignored) 

AC2 - DCT address 

Calling Sequence: . EXTN IBUF 

JSR @ .IBUF 
return - buffer full 
return - buffer not full 

. IBUF: IBUF 

Priority Enqueue a Bead (PENQU) 

PENQU places a bead and its buffer at the head of a bead string. If the device is 
not busy, it is started. 

Input: ACl - Bead address 

AC2 - DCT address 

Calling Sequence: . EXTN PENQU 

JSR @ .PENQU 
normal return 

• PENQU: PENQU 

Output: The bead and its associated buffer are attached to the beginning of the 
bead string. If the device is not busy, it is started. AC2 is unchanged 
upon exit. 

Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) 

XIBUF places a bead and its buffer at the head of a bead queue, and places an 
eight -bit character in the currently available buffer slot. All bookkeeping in the 
device's DCT is maintained. 

Input: ACO - Character 

AC2 - Base address of a dummy DCT. The only portion of 
this DCT which is used by the routine is the bead 
portion of the DCT: displacements DCTQL through 
DCTQS. It is this bead which is placed at the head of 
the device queue. 
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Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) (Continued) 

CaUing Sequence: . EXTN XIBUF 

JSR @ .XIBUF 

error return ;BUFFER FULL 

normal return 

.XIBUF: XIBUF 

Output a Character from the I/O Buffer (OBUF ) 

OBUF retrieves an eight -bit character from position PP of the input buffer if one is 
available. All bookkeeping in the DCT is maintained. 

Input: AC2 - DCT address 

Calling Sequence: . EXTN OBUF 

JSR @ . OBUF 
return - buffer empty 
return - buffer not empty 
.OBUF: OBUF 

Output: If the buffer was not empty, a character is returned in AGO, bits 8-15. 

I/O BUFFER MANAGEMENT 

As mentioned earlier, there is an I/O buffer for each device in the system, and its 
size may be increased or decreased by the addition or removal or buffer beads. At 
program base level (as opposed to interrupt level), users wishing to fetch a char- 
acter from a buffer issue either an RDL or RDS call which, in turn, calls another 
routine, RGHR. RCHR, RDL, and RDS are disk resident I/O routines in RING I/O. 
The purpose of RCHR is to perform a generalized character fetch using the Device 
Control Table address to read a character from the physical device. Having 
received a character from the btiffer, RCHR passes this character to the calling 
read routine. 

Each time RCHR is called, interrupts are disabled and OBUF is called. A character 
is fetched from the buffer, if one is available. (OBUF is a core resident routine in 
the lOBUF module, described earlier. ) If a character is not available in the buffer, 
the caller is suspended for a period of time less than or equal to the device timeout 
constant, DCTTO. If a timeout occurs, RTRN is executed; otherwise a loop back to 
the beginning of the RCHR sequence is made. 
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I/O BUFFER MANAGEMEm ^ (Continued) 

At interrupt level, input devices input characters to a buffer by means of a call to 
CISER, also described on the preceding page. 

A similar sequence of subroutine calls occurs for output devices. At program 
base level, a call to WRL or WRS results in a call to ACHR which adds a character 
to the I/O buffer. ACHR is a disk resident I/O routine which calls IBUF to add a 
character to the buffer. 

ACHR makes an attempt to place the character in the I/O buffer by means of a 
call to IBUF. IBUF, described earlier, performs functions complementary to those 
of OBUF. If the buffer was not full, then the character is added to the buffer and 
thence is output to the device (spooled, if possible). If the buffer was full, a spool 
for the data is started (if spooling is possible). Otherwise the system task is 
suspended for a period less than or equal to the device timeout constant. 

At the output interrupt level, COSER is used to output a character to the device. 



RDL 
RDS 



■*- RCHR- 



■OBUF 



Interrupt 
Service - 
Routine 



CISER 



INPUT DEVICE 



wrlL 

WRS \ 



ACHR ^?-— ^ IBUF 

OUTPUT DEVICE 



Interrupt 
Service — 
Routine 



COSER 



Retrieve a Character from the I/O Buffer (RCHR) 

Retrieve a character from the buffer by means of a call to OBUF. 



Input: 



AC2 - DCr address 



Calling Sequence: . EXTN RCHR OVLAY 

JSR @ .OVLY 
RCHR 

timeout return 
normal return 
.OVLY: OVLAY 



Output: 



ACO -(if successful) character in bits 8-15. 
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Add a Character to the I/O Buffer (ACHR) 

Insert a character in the I/O buffer by means of a call to IBUF. 

Input: AC2 - DCT address 

AGO - character to be inserted 

Calling Sequence: . EXTN ACHR, OVLAY 
JSR @ . OVLY 
ACHR 

error return 
normal return 
. OVLY : OVLAY 

The error return is taken in the event of a fatal disk error. 

Declaring the DCT Address 

The last relocatable binary in system library RDOSC. LB is TABLE. TABLE 
contains the interrupt vector, named ITBL, discussed earlier. This vector is 
a linear array of DCT addresses which the system interrupt handler indexes 
by device code. The form of each ITBL entry is: 

.dvdPCT: dvdPCT ; OCTAL DEVICE CODE 

where dvd represents the DGC device mnemonic for each device, and dvdD CT is 
the DCT address of each device. Each DCT address must be declared as a 
normal external. When adding an entry, the user can select any three -letter 
device mnemonic not used by a DGC device. 
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Creating a Peripheral Device Entry in a Directory 

All peripheral device entries are created (and deleted) as required on every 
initialization of a disk device. All information necessary to accomplish this 
is in the system overlay SFTAB. The information is as follows: 



Word 1 : 



Byte pointer (overlay relative) to entry name, 
packed left to right. 



Word 2 : 
Word 3: 



File attributes of the required entry. 

Logical device code. This is the same as the 
physical device code except in cases where 
two or more logical devices share the same 
device code, such as $TTI/$TTR. 



The latter part of the overlay contains the directory entry text strings. The 
text string for the paper tape reader, for example, is as follows: 



PTRP 

ATPER+ATWP+-ATCHA 

PTR 



NAME POINTER 

ATTRIBUTES 

LOGICAL DEVICE CODE 



FTRP: 



.TXTM 1 

. TXT /$FTR/ 
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Updating the System Libraries 

The RDOS 04 system libraries (RDOSA/MRDOSA/ARDOSA/BRDOSA etc. for system 
types 1-4) are arranged as shown in the following table. For a listing of the modules 
in any other libraries, perform an analyze via the library file editor (LFE). To 
add a driver, insert it into any of the libraries (A, B, or C) provided it is inserted 
after SYSTE (BSYSTE/MSYSTE/ASYSTE) and before TABLE (BTABLE/MTABLE/ 
ATABLE). 

The column labeled "CPU" describes the type of computer system which utilizes a 
specific relocatable binary module. CPU types and their keys are as follows: 



1 - Unmapped NOVA computer 

2 - Mapped NOVA computer 

3 - Unmapped ECLIPSE computer 

4 - Mapped ECLIPSE computer 
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SYSTEM LIBRARY LIST 



LIBRARY A: 



LIBRARY B: 



LIBRARY C: 



Relocatable Binary Title 


CPU 


INIT1,INIT2.INIT3 


1 


BINIT1,BINIT2.BINIT3 


3 


MPWRFL 


2.4 


MAPZ/AMAPZ 


2,4 


SCHED/MSCHED/BSCHED/ASCHED 


1,2.3.4 


SYMOD/MSYMOD/BSYMOD/ASYMOD 


1.2.3.4 


SYSTE/MSYSTE/BSYSTE/ASYSTE 


1.2.3.4 


OVLAY/OVLAY/BOVLAY/BOVLAY 


1,2,3,4 


OPPRO/MOPPRO/BOPPRO/AOPPRO 


1,2.3,4 


TTYID 


1.2.3,4 


TTYDR/MTTYDR/TTYDR/MTTYDR 


1,2,3,4 


DPMOD/DPMOD/BDPMOD/BDPMOD 


1,2.3.4 


RWBLK/MRWBLK/BRWBLK/ARWBLK 


1.2.3.4 


BLKIO/B LKIO/BBLKIO/BBLKIO 


1.2,3,4 


FILIO/MFILIO/BFILIO/AFILIO 


1,2,3,4 


GSUB/MGSUB/BGSUB/AGSUB 


1,2,3,4 


PLTID 


1,2,3.4 


PLTDR 


1,2.3.4 


CDRID 


1.2.3.4 


CDRDR/CDRDR/BCDRD/BCDRDR 


1.2.3.4 


PTPID 


1.2,3,4 


PTPDR 


1,2,3.4 


PTRID 


1.2.3.4 


PTRDR 


1.2.3.4 


LP132 


1,2.3,4 


LPI80 


1.2,3,4 


LP232 


1.2,3.4 


LP280 


1.2.3.4 


LPTID 


1,2.3.4 


LPTDR 


1.2.3.4 


lOBUF/IOBUF/BIOBUF/BIOBUF 


1,2.3.4 


M17DB through MOODB 


1.2.3.4 


C17DB through COODB 


1,2,3.4 


MTADR/MMTADR/BMTADR/AMTADR 


1.2,3,4 


MTAID 


1,2,3.4 


MTADC 


1,2,3,4 


CTAID 


1.2,3.4 


CTADC 


1.2.3.4 


STACKS/ST ACKS/BSTACKS/BSTACKS 


1.2,3,4 


CELLS 


1.2.3.4 


DKDCB 


1,2,3.4 


DKIDB 


1.2,3.4 


DSKDR/MDSKDR/BDSKDR/ADSKDR 


1.2,3.4 


DSKDC/DSKDC/BDSKDC/BDSKDC 


1.2,3.4 


DSK 1 D/DSK 1 D/BDSK 1 D/BDSK 1 D 


1.2,3.4 


DP7DB through DPODB 


1.2.3.4 


DKPDR/MDKPDR/BDKPDR/ADKPDR 


1.2.3.4 



Primary Function or Contents 

Full and partial system initializations 
Full and partial system initializations 
Mapped power fail handler 
Mapped system page zero 
System task scheduler 
. SYSTM call processor 
. SYSTM call table and processor 
System overlay handler 
Operator- Foreground /Background commu- 
nications 

Second Teletype driver 
Teletype/video display driver 
Dual processor module 
. RDB/. WRB and . EXEC/. RTN handler 
Block I/O Management 
Disk file I/O 

General purpose subroutines and linkage 
Second plotter driver 
Incremental plotter driver 
Second card reader driver 
Card reader driver 
Second high speed punch driver 
High speed punch driver 
Second high speed reader driver 
High speed reader driver 
132 column line printer characteristics word 
for $LPT 

80 column line printer characteristics word 
for $LPT 

132 column line printer characteristics word 
for SLPTl 

80 column line printer characteristics word 
for $LPT1 

Second line printer driver 
Line printer driver 
I/O buffer handlers 

Magnetic tape device control blocks 
Cassette device control blocks 
Magnetic tape/cassette driver 
Second magnetic tape device control table 
Magnetic tape device control table 
Second cassette device control table 
Cassette device control table 

System stacks 

System cells 

Fixed head disk DCB, first controller 

Fixed head disk DCB, second controller 

Fixed head disk driver 

First fixed head disk device control table 

Second fixed head disk device control table 

Moving head disk DCBs for units 7 through 

Moving head disk driver 
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SYSTEM LIBRARY LIST (Continued) 



Relocatable Binary Title CPU 

LIBRARY C: DKPDC, DKPDC, BDKPDC, BDKPDC 1, 2, 3, 4 

DKPID, DKPID, BDKPID, BDKPID 1.2. 3.4 

QTYDR.MQTYDR.BQTYDR.AQTYDR 1,2.3,4 

MCT1D,MMCT1D,MCT1D,MMCT1D 1,2,3,4 

MCTDC, MMCTDC. MCTDC, MMCTDC 1,2,3,4 

MCADR, MMCADR, BMCADR, AMCADR 1. 2. 3, 4 

P31DB through POODB 1.2.3,4 

PWRFL 1 

BPWRFL 3 

INTD.MINTD.BINTD.AINTD 1,2,3.4 

PANIC 1,2,3,4 

TABLE.MTABLE.BTABLE.ATABLE 1.2.3,4 



Primary Function or Contents 

First moving head disk device control table 

Second moving head disk device control table 

Asynchronous multiplexer driver 

Second MCA device control table 

First MCA device control table 

MCA driver 

Partition /subdirectory DCBs 31 through 

Unmapped NOVA power fail handler 

Unmapped ECLIPSE power fail handler 

Interrupt determinater 

System PANIC handler 

Tables section 
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Updating the System Libraries (Continued) 

For more information about the contents of the RDOS 04 libraries, perform an 
analyze. 

Creating a System Queue Entry 

A system queue must be created for the device within the device driver. The 
structure of this entry is as follows: 



dvdQ: . ENT dvdQ 

• BLK 2 
100000 
dvdDCT 



USED TO POINT TO DCT AND UFT 
SYSTEM STACK IS REQUIRED 
DCT ASSOCIATED WITH QUEUE 



.BLK SQLN-.-fdvdQ ;SYSTEM STORAGE AREA 

The address of this queue entry must be defined in the system queue table (SQ) in the 
TABLE mode. 

An example of this queue entry for the paper tape reader is as follows: 

PTRQ: .BLK 2 

100000 
PTRDCT 
. BLK SQLN-. +FTRQ 

System Generation 

Invoke the SYSGEN save file and answer all queries. Determine the additional 
space necessary to load the new user driver plus any additional words added to 
the system. Before creating the new operating system save file, the value contained 
in the file named NREL should be adjusted down by the additional amount of space 
required by the new device driver. 

To insure that the driver wiU get loaded from the library at system generation 
time, a small program should be written and loaded at this time ahead of the 
RDOSA. LB (MRDOSA. LB) library. The program could take the following form: 

.EXTN dvdDC 
.END 

and the relocatable binary called DUMMY. RB. 
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System Generation (Continued) 

File SYSGEN. CM must be modified so that DUMMY appears as an entry after 
@NREL@. 

Invoke SYSGEN. CM to build the new RDOS system 

PRACTICAL HINTS FOR SYSTEM DEVICE DRIVER IMPLEMENTATION 

This section is devoted to a line-by-line examination of an actual RDOS driver, 
the high speed paper tape reader. 

Elements Required in User-Written I/O Routines 
User device drivers may perform I/O in three ways: 

1. By using system routines, placing the routine names in the user 
device dispatch table. 

2. By appending some pre-processing instructions to an existing 
system routine. 

3. By substituting system I/O routines with user written routines, and 
either placing these routines in-line or by placing the routine names 
in the dispatch table. 

The first case, placing a system I/O routine name in the device dispatch table, is 
the easiest to implement. 

In the second case, where the user wishes to do some pre-processing of input para- 
meters,* then transfer control to a system routine, the following steps must be 
followed. The steps in this example illustrate the case where RDL is the system 
call which will have instructions appended to it by the user: 

1. Perform a SAVE before calling RDL. 

2. Ensure that RDL is passed its requisite parameters. These are the 
UFT addresses in AC2 and the destination bjrte pointer in ACO. Use 
the RDL calling sequence defined earlier. 

3. Perform an RTRN upon return from the call to RDL. 

In the last case, a user wishes to write an I/O routine which will be used instead of 
a system routine (perhaps placing this routine in his driver module). 



except upon opening or closing a device. 
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Elements Required in User -Written I/O Routines (Continued) 

The following example sketches the essential elements of such a routine (leaving 
blank the I/O code sequence proper) : 





.ENT 


RDLl 


RDLl: 


STA@ 
RSAVE 


3,CSP 




LDA 

• 


0, OACO, 3 




• 

MOV# 


2,2,SNR 




JMP 

• 


TIMEOUT 




• 

ISZ 


ORTN, 3 




RTRN 




TIMEOUT: 


T.nA 


2, ERROR 




STA 


2,OAC2 




RTRN 




ERROR: 


EREOF 





;SAVE CALLER'S AC'S 
;FETCH INPUT ACO 

;TEST FOR END OF FILE ERROR 



;G0 TO NORMAL RETURN 

;GET ERROR CODE 

;RETURN ERROR CODE IN AC2 



Examination of a System Device Driver 

This section is devoted to a line -by -line examination of an actual RDOS driver, the 
high-speed paper tape reader driver (PTRDR). 

Following are the first 11 lines of the REXDS paper tape reader driver: 



100(02 PTRDR 
01 

03 
04 
05 
06 
07 
06 
09 
10 
11 



.TITLK PTRDRV ; PAPER TAPE READER DRIVER 

,NREL 

,ENT PTRDC,PTRO,PTRDT,PTREX 

,fcXTN ROS,nPNI,CLSl,RDL rCOMMANO ENABLE 
.EXTN XNIOS lEXECUTE I/O INSTRS 
.eXTN CISER ^INTERRUPT SERVICE 
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Examination of a System Device Driver (Continued) 

The entries PTRDC and PTRQ on line 6 define the PTR Device Control Table address 
and the system queue entry respectively. PTRDT and PTR EX define the dispatch 
table address and the execute - I/O instruction routine respectively. PTRDT and 
PTREX are entered so that they can be referenced by PTR ID, the second paper 
tape reader driver. 



12 
19 
14 
15 
16 
17 

Id 

19 
20 
21 
22 

2d 
24 
25 
26 
27 
26 
29 
30 
31 
32 
9d 



t PAPER tape: reader neviCE control table 



001(3M0'K!ipi(il000 PTRDCTI 
001501 'id01737 
i}0U02U77777 

00l^03ie)00404 
00004 *«90lij0 12 
00005<000065> 
00006'id0l£ill0' 

001^10 '00l<!i 100 

00011 •00e052" 

fci»012 '00k^(9(dl. 

0001d)id0li^0tt)l 

00014'00iiP001 

0^01d'000001 

00kilbi00k10i,!!l 

00017 '(340011 

00020'000014» 

00fe52l '177777 

00022'00k.002 

00024'000002 





MKPTR 

CISER 

DCIDItOCPCK 

PTR 

PTREX 

PTRDT 

XNIOS 

PTRSZ*2 

PTRBF*2 

.BLK 1 

.BLK 1 

.bLK 1 

.BLK I 

.BLK I 

BSUPC+BSDONt 

.-4 

-1 

.BLK 2 

2 



} MASK 

hnt service 

i characteristics 
idevice code 
;£xecute 10 instruction 

i dispatch table address 

i reader start routine address 

i buffer size 

; buffer first byte address 
^program byte count 
^program byte pointer 
/device bead link 
;device data byte pointer 

FDEVICE data COUNT 
BSLPA I BEAD STATUS 
;BEAD ADDRESS 
IREQUEST QUEUE POINTER 
/DEVICE TEMPS 
/TIME OUT IN SECONDS 



Locations through 24 (lines 14 -33) comprise the paper tape reader Device Control 
Table (DCT). Word 1 (line 15) defines the interrupt mask. The paper tape reader 
mask word, 1737, prevents all devices with mask bit assignments 6-9 and 11-15 
inclusive from interrupting the reader (thus preventing chatter); see PARS, Device 
Interrufrt Masks, Word 2 specifies that reader interrupt service is performed by 
CISER, the common interrupt service routine found in the lOBUF module. Words 4 
and 5 define the device characteristics and device code; DCIDI indicates that the 
reader requires operator intervention, while DCPCK indicates that the reader is a 
device requiring an even parity check on input. 

PTREX, word 5, is a pointer to the reader I/O execute instruction area. This area 
will be seen later. PTRDT points to the reader dispatch table; this table will be 
seen on page 2 of the reader driver listing. XNIOS, line 21, is an entry in the 
lOBUF module and will be resolved by the loader. XNIOS starts the reader. 
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Examination of a System Device Driver (Continued) 

Finally, on page 3 of the driver listing we find the paper tape reader dispatch 
table, PTRDT. This table provides entries to open and close the reader and to 
perform read line and read sequential operations: 



01 
02 
^6 
(94 
0& 
06 
07 
0b 
09 
10 
11 
12 
\i 
14 
15 
lb 
17 
It) 
1» 



03 PTRUR 



00110 
00111 
00112 
001U 
00114 
fc)011b 
00116 
00117 

00120 
00121 
00122 
0012^ 



f DtFINE THE PAPEH TAPE READER DISPATCH TABLE 



177777 PTRUTJ OPM 



\77777 
177777 
177777 
177777 
177777 
177777 
177777 
177777 

001^110* 
00«^121 ' 

177777 



CLSI 

RDS 

RDL 



nPNI 

npNi 
-I 



• END 



PTR OPEN 

PTR CLOSE 

PTR READ SEQUENTIAL 

PTR READ LINE 

PTR READ RANDOM 

PTR WRITE 8EQ 

PTR WRITE LINE 

PTR WRITE RANDOM 

PTR OPEN FOR APPENDING 

PTR READ ONLY OPEN 

PTR EXCLUSIVE OPEN 

PTR TRANSPARENT OPEN 



The read random record and all write commands are illegal for the paper tape 
reader. This is indicated by the placement of -1 tn these positions of the dispatch 
table. 

Following is the cross-referenced symbol listing for the paper tape reader driver: 
0004 PTKOR 



3/15 



CIStR 


000k302< 


XN 


2/10 


2/16 




CLSI 


0001111 


XN 


2/0& 


3/06 




OPNI 


000122* 


XN 


2/08 


3/05 


3/14 


PTRbH 


00O02:>' 




2/23 


2/37 




PTRDC 


0k30l^0fc." 


EN 


2/06 


2/14 


2/46 


PTRDT 


0ld0llki' 


EN 


2/06 


2/20 


3/05 


PTREX 


0e)0i^6&' 


EN 


2/06 


2/19 


2/39 


PTRU 


0i^0ii!)7)c' 


EN 


2/06 


2/44 


2/47 


PTRSZ 


0^10040 




2/22 


2/35 


2/37 


RDL 


0001U' 


XN 


2/08 


3/0d 




RUS 


0ta01U' 


XN 


2/08 


3/07 




XNIOS 


Mld00(47 ' 


XN 


2/09 2/21 

♦ ♦♦♦♦ 
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CHAPTER 3 

USER PROGRAM SERVICED INTERRUPTS 

SERVICING USER INTERRUPTS 

Special user devices may be identified either at the time an RDOS system is loaded 
or at run time. This chapter describes the procedure for identifying a user device 
at run time and for creating a user clock driven by the system real time clock. 
The considerations given for identifying a user device are common to both single 
and multitask environments; the user clock facility may also be used in both task 
environments. Only ten (decimal) user devices --excluding the user clock --can be 
identified to the system at any moment. 

Upon detection of an interrupt request, the system will be dispatched through the 
device interrupt vector table, . ITBL (see Chapter 1). In this table are pointers to 
Device Control Tables (DCTs) for devices established at system initialization time, 
whether system or user devices. Chapter 1 describes the structure of system DCTs, 

User Device Driver Implementation at Run Time 

In order to identify a user device to the system at run time, the user must provide 
a three -word DCT as an interface between the system interrupt dispatch routine 
and the user -interrupt servicing routine. The structure and mnemonic assignments 
of this three -word table are as follows: 

Displacement Mnemonic Purpo$e 

DCTBS Pointer to an 8 -word state save area. 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCTBS is a pointer to an eight word state variable save area reserved for com- 
patibility with RTOS. In RDOS, state information is reserved on the interrupt stack. 
DCTIS is a pointer to the routine which services this particular device interrupt . 
DCTMS is the interrupt mask* that the user wants to be ORed with the current 
interrupt mask while in the user interrupt service routine. This mask establishes 
which devices --if any --will be able to interrupt the currently interrupting device. 

Upon transferring control to the user interrupt service routine, the system will 
ensure that ACS contains the return address required for exit from the routine, 
and that AC2 contains the address of the DCT upon exit from the routine. 

* See "How to Use the NOVA computers, " Section 2.4. 
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User Device Driver Implementation at Run Time (Continued) 

Exit is accomplished by issuing task call . UIEX; rescheduling may occur as an 
option. 

All multitask environment activity ceases at the moment that a user device 
interrupt is detected. Nonetheless, it is possible for a user to communicate a 
message to a task from a service routine. If the task in question has been 
expecting such a message through issuance of a . REC and is now in the suspended 
state, issuance of the message via . IXMT will cause that task to be readied 
even though multitask activity is in abeyance. If no task has issued a .REC for 
such a message, . IXMT simply posts the message and takes no further action. 
For more information on communicating to tasks from a user interrupt service 
routine, see Chapter 5 of the RDOS User's Manual, 093-000075-04. 

In addition to , IXMT, certain other task calls can be issued from a user 
interrupt routine or user power fail routine. A complete list of these task calls 
follows: .IXMT, . SMSK, .UIEX and .UPEX. 

All user devices are removed from the system when either a program swap or 
chain occurs. Receipt of a user interrupt on a new program level (which has not 
identified the user device) will cause the system to clear the device's done and 
busy flags and then return to normal program execution. 

Identify a User Interrupt Device (. IDEF) 

In order to introduce to the system those devices (not identified at SYSGEN time) 
whose interrupts the system is to recognize, the system call . IDEF must be 
issued. This places an entry in the interrupt vector table. AGO contains the 
device code of the new device. AGl contains the address of the new device's 
DGT. In unmapped systems, this address must exceed 4008! in mapped systems, 
bit of this address is set if the device is a data channel device. In mapped 
systems with a device using the data channel, AC2 contains the number of IK 
core memory blocks which will be needed by the data channel map. This number 
will be one larger than the integer number of 1024io word blocks used for data 
channel core buffers. The format of this command is: 
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Identify a User Interrupt Device (.IDEF) (Continued) 

. SYSTM 
.IDEF 

error return 
normal return 



Possible error messages are: 

AC2 Mnemonic 



36 



ERDNM 



45 ERIBS 

65 ERDCH 

74 ERMPR 



Meaning 

Illegal device code (> 778). Device code 
778 is reserved for the power monitor /auto 
restart option. 
Interrupt device code in use. 
Insufficient room in data channel map. 
Address outside address space (mapped 
systems only). 
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Exit from a User Interrupt Routine (. UIEX) 

Upon a user device Interrupt, ACS will contain the return address upon entry to the 
user routine. 

In unmapped systems, before issuing task call . UIEX ACS must be loaded with the 
return address that it contained upon entry to the user routine. In mapped systems, 
the contents of ACS are ignored when . UIEX is issued. In both mapped and unmapped 
systems, rescheduling of both the task and program environment (if a foreground/ 
background system) will occur upon exit only if ACl contains some non-zero value. 
If compatibility with RTOS is to be maintained, AC2 must be restored to the value 
it had upon entry to the user interrupt routine. 

The format of this call is: 

ACl - Zero only if rescheduling is to be suppressed. 
ACS - Return address upon entry to routine (unmapped systems 
only). 

.UIEX 

Control returns to the point outside the user routine which was interrupted by 
the user device. No errors are possible from this call. This call can be 
issued in a single task environment. 

Remove User Interrupt Servicing Program (. IRMV) 

To prevent the system's recognition of user interrupts which have been previously 
identified by the . IDEF command, the . IRMV command is issued. Required input 
to this call is the user device code corresponding to the device which is to be 
removed. 

The format of this call is : 

AGO - Device code. 

. SYSTM 
.IRMV 
error return 
normal return 
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Remove User Interrupt Servicing Program (.IRMV) ( Continued) 
One possible error message may be given. 
AC2 Mnemonic Meaning 



36 



ERDNM 



Illegal device code ( >778) or attempt to 
remove a system device (i.e. , one 
established at SYSGEN time). 



Set the Data Channel Map (.STMAP) 

User devices employing the data channel in mapped systems must issue a 
system call to set up the data channel map. (A separate map is maintained by 
the mapping hardware for data channel usage. ) This call sets up the data channel 
map for the user device and returns in ACl the logical address which should be 
sent to the device. Required inputs to this call are the user device code in AGO, 
and in ACl the starting address of the device buffer in user address space. 



The format of this call is: 

. SYSTM 
. STMAP 
error return 
normal return 

This call is a no-op when issued in unmapped systems. In mapped systems, 
two possible error conditions may occur. 

AC2 Mnemonic Meaning 

36 ERDNM Device code not previously identified as a data channel device. 

74 ERMPR Address outside address space (mapped systems only). 
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Modifying the Current Interrupt Mask (. SMSK) 

Whenever a user interrupt occurs, the interrupt mask is ORed with the mask con- 
tained in DCTMS of the user DCT to produce the current interrupt mask. None- 
theless, it is possible in the service routine to produce a current mask which 
ignores the contents of DCTMS, producing a new mask which is the logical OR of 
the old mask (upon entry to the service routine) and a new value. If compatibility 
with RTOS is to be maintained, AC2 must be restored to the value it had upon 
entry to the user interrupt routine. This is done by task call . SMSK, whose format 
is as follows: 



ACO - New value to be ORed with old mask. 

.SMSK 
normal return 

There is no error return possible from this call. This call may be issued in a 
single task environment. 



WRITING USER POWER FAIL SERVICE 

RTOS provides software support for the power fail/automatic restart option. 
Upon detection of a power loss, the system transfers control to a power fail 
routine which saves the status of accumulators through 3, the PC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 

**POWER FAIL** 

is output on the system console and the state variables are restored before 
control resumes operation at the point where it was interrupted. If the console 
key was in the ON position when input power failed, the user must set the 
console switches to all zeroes (down) and START must be pressed when power is 
restored. This causes the console message to be output and state variables to 
be restored as when the key is in the LOCK position. 

The following system devices are given power-up restart service by RDOS: 
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WRITING USER POWER FAIL SERVICE (Continued) 

paper tape readers /punches 

Teletypes 

quad multiplexors 

card readers 

line printers 

disks 

Character devices may lose one or more characters during power up. Each card 
reader may lose up to 80 columns of information on a single card. Line printers 
may lose up to a single line of information. Since power up service for disks 
includes a complete re-read or re -write of the current disk block, no disk 
information is lost, although moving head disk units will require 30 to 40 seconds 
before disk operations can continue. Devices requiring operator intervention 
(like line printer, card readers, etc. ) must receive such action if power was 
lost for an extended period of time. No power up service is provided for 
magnetic tape or cassette units. 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call . IDEF. The format of this 
call when used to identify user power up service is as follows: 



AGO 


778 


ACl 


Starting address of user power up service 




routine. 


. SYSTM 




.IDEF 




error return 




normal return 





The error return is never taken. 

Exit from a user power-up service routine in both mapped and unmapped systems 
forces rescheduling and is accomplished by task call . UPEX. The same restrictions 
applying to the use of system and task calls in a user interrupt service routine 
apply to a user power fail routine. 
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Exit from a Power Fail Service Routine (.UPEX) 

Upon entering a user power fail service routine, ACS will contain the address 
required for exit from the routine. To return from the user power fail routine 
in an unmapped environment, ACS must be loaded with this return address and 
task call .UPEX must be issued. In mapped systems, the value input in ACS 
when this call is issued is ignored. 

The format of this call is : 

ACS - Return address upon entry to the routine (unmapped systems 
only). 

.UPEX 

Control returns to the location which was interrupted by a power failure. 
No error return or normal return need be reserved. . UPEX can be issued in 
a single task environment. Note that this call can be issued only in revision 03 
and higher revisions of RDOS. 

USER PROGRAMMED CLOCK 

Two system commands, . DUCLK and . RUCLK, are available to permit the 
definition and removal of a user clock driven by the system's real time clock 
(RTC). A user clock routine gains control at user -definable intervals. When one 
of these intervals expires, control goes to a user -specified routine outside the 
current single or multitask environment. No task calls (other than . IXMT, , SMSK, 
and . UCEX) may be issued from this interrupt servicing routine. 

Define a User Clock (. DUCLK) 

This command permits the definition of a user clock. When the user-defined 
interval expires, the task scheduler and multitask environment - -if any-- are placed 
in suspension, and control goes to a user -specified routine. No system or task 
call (except . UCEX, . SMSK, . IXMT, and . UCEX) may be issued from this user 
routine. Moreover, in NOVA systems assembly instruction INTEN cannot be 
issued. 
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Define a User Clock (. DUCLK) (Continued) 

The format of this call is : 

ACO - Integer number of RTC cycles to elapse 

between each user clock interruption. 

ACl - Address of user routine to receive control 

when each interval expires. 

. SYSTM 
. DUCLK 
error return 
normal return 

If the error return is taken, the following error code is issued: 

AC2 Mnemonic Meaning 

45 ERIBS A user clock already exists 

Upon a user clock interrupt, ACS will contain the address of the return upon 
entry to the routine specified in . DUCLK. To return from the user clock routine 
in an unmapped environment, ACS must be loaded with the return address that it 
contained upon entry to the routine and task call . UCEX is issued. In mapped 
systems, the value input in ACS when this call is issued is ignored. In both mapped 
and unmapped systems, rescheduling of both the task environment and the program 
environment (if a foreground /background system) will occur upon exit only if 
ACl contains some non-zero value. 

The format of this call is: 

ACl - Zero only if rescheduling is to be suppressed. 
ACS - Return address upon entry to routine (unmapped 
systems only). 

.UCEX 

Control returns to the point outside the user routine which was interrupted by the 
user clock. No errors are possible from this call. This call can be issued in a 
single task environment. 

Remove a User Clock (.RUCLK) 

This system command removes a previously defined user clock from the system. 
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Remove a User Clock (. RUCLK) (Continued) 
The format of this call is : 

.SYSTM 
. RUCLK 
error return 
normal return 

The error return must be reserved, but it is never taken. 

EXAMPLES OF USER SERVICED INTERRUPTS 

This section illustrates two implementations of user-written interrupt servicing 
programs for devices not incorporated into the system at SYSGEN time. 

Analog to Digital Converter 

The first of the two illustration programs is an analog to digital converter driver, 
found on page 3-12. This driver consists of four subroutines which can be called 
from a user program, the intermpt servicing subroutine, and a Device Control 
Table. The following is a line by line analysis of the A/D driver. 

Lines 6-10 show that the title of the driver is AIDEV, that four entry points exist 
for user access of this driver, and that the driver program is normal relocatable 
(i.e. , that it does not use any page zero locations). Line 15 gives the address of 
the Device Control Table which is defined in lines 17-19. This is an abbreviated 
DCT as discussed earlier. 

The first location in the DCT (line 17) points to an 8 -word state save area defined 
on line 30. The second entry in the table is the hardware mask that is set while the 
K/D interrupt is serviced. 1B8 indicates that all other devices can interrupt the 
A/D converter. The third and final entry in the DCT is the address of the interrupt 
servicing program, AINTS. AINTS is found on page 4 of the driver Listing, and 
will be discussed later. 

Lines 25 - 29 contain additional variables and constants which are required while 
servicing requests to this handler. These values are, in order, the device code 
of the k/D converter, a busy/done status flag, pointers to the address and data 
tables, and the number of points to be read for this call. 

Page 2 of the driver Listing illustrates two subroutines called by the user to attach 
(detach) the K/D converter interrupt servicing routine to (or from) the RDOS 
dispatch table, ITBL. The first routine, AIDEF, clears the ACTIV flag to indicate 
that there are no active requests in the handler for data. AIDEF then issues the 
system call .IDEF to define this handler and introduce it to RDOS. An error return 
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Analog to Digital Converter (Continued) 

could result if the k/D converter device code (21 s) already was assigned to some 
other device. This would happen if a second call to AIDEF were issued without 
any intervening call to AICLR. AICLR removes the A/D routine from theRDOS 
dispatch table. 

Page 3 of the driver listing contains two subroutines, the analog read random routine 
(AIRDR) and the read request routine (AICHK). The first of these routines, AIRDR, 
is called with AC2 containing the address of a control table. This table is described 
on page 1 of the listing (lines 34 - 50). This subroutine first checks whether the 
device is currently active on another request by testing the ACTIV flag defined 
earlier (page 1, line 26). If the handler is already active, an error return is made 
to the user. K the handler is not active, the ACTIV flag is set and the request is 
initiated. The address of the control table is saved in the active switch and the num- 
ber of points to be read is moved into the handler from the table. Since this routine 
performs reads of analog inputs, two tables must be provided by the user. One 
table must contain the input point addresses to be read, and the other table (of equal 
or greater size) is used to store the analog input readings. The addresses of these 
two tables is given in the control table. Before returning control back to the caller, 
the address of the first point is fetched, sent to the converter, and the converter 
is started. 

The fourth routine, AICHK, is used to check the status of a call made to the 
converter. There are two returns to the caller: busy and call completed. 
Page 4 of the driver listing contains the interrupt service routine, AINTS. This 
routine is entered from the RDOS interrupt dispatch program with AC2 containing 
the address of the A/D converter DCT and AC3 containing the address of the 
RDOS interrupt dismissal program. AINTS reads the new converted value, saves 
it in the user-supplied data buffer, and then checks to see if there are additional 
points to be read. If there are, it initiates the next conversion. If this was the 
last point to be read, AINTS sets the status of the request to indicate that the call 
is completed and the handler is available for the next user request. 
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0001 AIDEV MACRO REV 02 01M«I26 12/08/73 

01 

B2 t ANALOG TO DIGITAL CONVERTER DEVICE DRIVER 

03 f ^•■^•■^-••••••-•••••-. ...«..«.«... __..,.•.... 

04 I »•. — .—..,.. — .-.....^..•.... ........... 

05 

,TITL AIOEV 
07 

08 ,ENT AI0EF,A1CLR»AIRDR,AICHK 

09 

10 .NREL 

U 

la I DEVICE CONTROL TABLE LAYOUT 
J3 f -,— 

14 

15 000001000001 UODCTI USOCT I ADDRESS OF ADCV DCT 

16 

17 «000l»0000U«USOCTl AI8AVE I INTERRUPT STATE SAVE AREA 

18 000021000200 IBB t MASK NQRD 

18 00003'000063t AINTS I INTERRUPT ROUTINE ADDRESS 

20 

21 I ADDITIONAL VARIABLES FOR ADCV HANDLER 

22 I •^.•*..w— ..*..— 

23 

24 000041000021 DCODEI ADCV I DEVICE CODE OF A/O CONVERTER 

25 00005>000000 ACTIV; I STATUS FLAG 

26 00006'000000 OAPTRI I DATA ADDRESS ARRAY POINTER 

27 00007>00000(» DVPTRJ I DATA VALUE ARRAY POINTER 

28 000101000000 DTCNTI f DATA COUNT STORAGE 
29 

30 000111000010 AISAVEt .BLK 10 I STATE SAVE AREA 

31 

32 

33 

34 

99 

36 

37 

98 

99 

40 

41 

42 

49 

44 

45 

46 

47 

48 

49 

50 



000000 
000001 
000002 
000003 



USER CONTROL TABLE LAYOUT 
WORD 



WORD 1 
WORD 2 
WORD 3 



STATUS FLAG 
■ CALL COMPLETED SUCCESSFULLY 
•VE ■ REQUEST BEING PROCESSED 

ADDRESS TABLE POINTER 

DATA STORAGE TABLE POINTER 

NUMBER OF POINTS TO BE READ 



OUSR 
DUSR 
OUSR 
DUSR 



STAT«0 

ATPTR-1 

VTPTR«2 

NPT«3 
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10002 
01 
02 
03 

04 
09 
06 
07 
08 
09 
10 
U 

u 

13 

14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
39 
34 



AZ 



LICENSED 
OEV 



MATERIAL « PROPERTY OF DATA GENERAL CORPORATION 



00021 
00022 
00023 
00024 
00025 
00026 
00027 
00030 
00031 



1054016 
'102400 
'040762 
1020760 
•024753 
'006017 
1021007 
'001400 
'001401 



00092 
00033 
00034 
00035 
00036 
00037 



'054016 
1020751 
1006017 
'021010 
•001400 
'001400 



1 INITIALIZE THE A/D HANDLER 

I ..p^w— .*—.•.---«..*— .•—. 

f CALLING SEQUENCEI 

f JSR AIDEP 

I <ERROR RETURN> I DEVICE CODE IN USE ALREADY 

I <NORMAL RETURNS 



AIDEFl 



8TA 3 USP 

SUB 

8TA ACTIV 

LDA DCODE 

LOA 1 ADDCT 
.SYSTM 
.IDEF 

JHP 3 

JMP I 3 



f SAVE RETURN ADDRESS 

I SET ROUTINE NOT BUSY 

t GET DEVICE CODE 

1 GET OCT ADDRESS 

1 ATTACH TO RDOS INTERRUPT SYSTEM 

t ERROR RETURN 

f NORMAL RETURN 



I DETACH THE INTERRUPT SERVICING ROUTINE 

I .«.^..,..,.....«*.......—.— ........ 

I CALLING SEQUENCEI 

f JSR AICLR 

I <NORMAL RETURN* 



AICLR» 



STA 3 USP 
LDA DCODE 
.SYSTM 
.IRMV 
JMP 3 
JMP 3 



f SAVE RETURN ADDRESS 

; DETACH FROM RDOS INTERRUPR SYSTEM 

f NORMAL RETURN 
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10009 

01 

02 

03 

04 

05 

06 

07 

00 

09 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

90 

31 

32 

93 

34 

95 

36 

97 

98 

99 

40 

41 

42 

49 

44 

45 

46 

47 



IICENSED 
AXDEV 



MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 



00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00050 
00051 
00052 
00053 
00054 
00055 
00056 



1020745 
'101004 
1001400 
1050742 
•021003 
1040749 
1021001 
1040797 
1021002 
1040736 
•102000 
•041000 
1022732 
•061121 
'001401 



f ANALOG READ RANDOM SUBROUTINE 

f INPUTI 

1 AC2"C0NTR0L TABLE ADDRESS 

r CALLING SEUENCEl 

1 J8R AIRDR 

1 <ERROR RETURN* | HANDLER ALREADY ACTIVE 

1 «NORMAL RETURN* 



000571021000 
00060>101004 
00061*001400 
000621001401 



AIRORI 



LOA ACTXV 
MOV SZR 



JMP 
STA 2 



3 
ACTIV 



LDA NPT 2 

STA DTCNT 

LDA ATPTR S 

STA DAPTR 

LDA VTPTR i 

8TA DVPTR 

ADC 

STA STAT 2 

LDA HDAPTR 
DOAS ADCV 

JMP I 3 



I PICKUP STATUS FLAG 

I CHECK IT 

f ALREADY ACTIVE— ERROR RETURN 

I SAVE CONTROL BLOCK ADDRESS 

; GET » POINTS TO BE READ 

I SAVE AS DATA COUNT 

I GET STARTING ADDRESS OF POINT AODRESSE 

f SAVE POINT ADDRESS TABLE 

I GET VALUE STORAGE TABLE ADDRESS 

I SAVE FOR STORING VALUES 

I SET REQUEST ACTIVE STATUS 

f GET FIRST POINT ADDRESS 

I START UP CONVERSION 

I TAKE NORMAL RETURN 



ANALOG INPUT READ REQUEST CHECK SUBROUTINE 



INPUTI 

AC2IC0NTR0L TABLE ADDRESS 

CALLING SEQUENCE! 
J8R AICHK 
<BU8Y RETURN* 
«COMPLETED RETURN* 



AICHKI 



LDA STAT 2 

MOV SZR 

JMP 3 

JMP I 3 



I GET CALL STATUS 

I REQUEST BEING PROCESSED 
I CALL COMPLETED 
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{0004 

9i 

08 

09 

04 

08 

06 

07 

08 

09 

10 

U 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 



AI 



LICENSED 
OEV 



MATERIAL * PROPERTY OF DATA GENERAL COKPQRATION 



00063 
00064 
00065 
00066 
00067 
00070 
00071 
00072 

00073 
00074 
00075 
00076 



'062621 
•042723 
1014729 
'000405 

1102400 
'042715 
1040714 
'001400 

'010713 
'010713 

'022711 
'061121 

'00140« 



I ANALOG TO 



DIGITAL CONVERTER INTERRUPT ROUTINE 



1 INPUTS 

I 



AC2*DCT ADDRESS 

AC31INT6RRUPT DISMISSAL ROUTINE ADDRESS 



AINTSI Dice ADCV 

8TA #DVPTK 

DSZ DTCNT 

JMP AIMORE 

SUB 

STA #ACTIV 

STA ACTIV 

JMP 3 

.AXMOREI ISZ DAPTR 
I5Z DVPTR 
LDA #OAPTR 
OOAS ADCV 
JMP 3 

• END 



I READ VALUE— 'CLEAR CONVERTER DONE FLAG 

I SAVE NEWLY READ DATA VALUE 

I DECREMENT DATA COUNTER 

I MORE TO COME 

I REQUEST COMPLETE 

f SET USER DONE FLAG 

t SET CONVERTER NON-BUSY 

1 DISMISS THE INTERRUPT 



INCREMENT 



ADDRESS POINTER 
DATA TABLE POINTER 

SETUP NEXT CONVERSION 

START IT 

DISMISS THE INTERRUPT 



0005 

ACTIV 
ADOCT 
AICHK 
AICUR 
AIDEP 
AIMOR 
AINTS 
AIRDR 
AI8AV 
DAPTR 
DCODE 
DTCNT 
DVPTR 
USDCT 



LICENSED 
AZOEV 



MATERIAL • PROPERTY OF DATA GENERAL CORPORATION 



000005' 
0000001 
000057' 
000032' 
000021' 
000073' 
000063' 
000040' 
000011' 
000006' 
000004' 
000010' 
000007' 
000001' 



EN 
EN 
EN 



EN 



1/25 
1/15 

1/08 
1/08 
1/06 
4/13 
1/19 
1/08 
1/17 
1/26 
1/24 
1/28 
1/27 
1/16 



2/12 
2/14 

3/44 
2/29 
2/10 
4/19 
4/10 
3/15 
1/30 
3/22 
2/13 
3/20 
3/24 
1/17 



3/lS 



3/ie 4/15 



4/16 



3/27 
2/30 
4/12 
4/11 



4/19 4/21 

4/20 
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External Interrupt Recognition 

This driver program illustrates an interrupt servicing routine which readies a 
user task as a result of an external interrupt. This program illustrates a type 
4066 digital interface device driver. 

Page 1 of the listing is almost identical in form to the first page of the A/D driver 
listing discussed earlier. The only difference is in the variables and storage 
required by the digital interface. Here, the user must supply the address of a 
communications core location. When a call is made to attach the interrupt routine, 
address to the RDOS dispatch table (page 2 of the listing), AGO must contain the 
communications core address. After attaching the interrupt to the RDOS dispatch 
vector table, the initialization routine arms the digital interface so that is can 
cause an interrupt. 

When the external interrupt occurs, control is dispatched to the digital interface 
servicing routine, starting on line 38 of page 2. After the service routine gains 
control, it reads a sixteen bit digital register provided by the interface. If the 

register's contents are non-zero, the contents are transmitted to a user task using 
the task call . IXMT; after this, the interrupt is dismissed. If the register's 
contents is zero, the interrupt is simply dismissed. Upon dismissal of the 
interrupt, the system re -arms the digital interface interrupts. 

A practical example of the use of such a scheme would be the servicing of an 
operator's console. Such a console would generate an external interrupt indicating 
that the operator desires some form of action by the computer; the sixteen bit 
register contents (selected by the console operator) would indicate exactly the type 
of action desired. 
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0001 DZDEV HACRO REV 02 01111102 12/06/73 

01 
02 

03 t DIGITAL INTERFACE (TYPE 4066) DEVICE DRIVER 

04 1 ..^.-...^ , 

09 f ,i»,......« ,....—...........,.. 

06 

.TITL DIDEV 
06 

09 .ENT DIDEFiOICLR 

10 

11 .EXTN ,IXMT 

12 

13 .NREL 

14 

15 000042 .OUSR DIQi42 1 DEVICE CODE DEFINITION 
16 

17 I DEVICE CONTROL TABLE LAYOUT 

16 I -^ - - 

19 

20 000001000001 'DIDCTi USDCT 1 ADDRESS OF DID OCT 

21 

22 00001 *000004fUSDCTI DISAVE f INTERRUPT STATE SAVE AREA 

23 00002<000400 1B7 ; INTERRUPT MASK 

24 00003<000036i DINTS I INTERRUPT ROUTINE ADDRESS 
25 

26 F ADDITIONAL VARIABLES AND STORAGE USED BY HANDLER 

27 t -- P-- » 

26 

29 000041000010 DISAVEl .BLK 10 I STATE SAVE AREA 

30 000141000042 DCODEI DID I DEVICE CODE 

31 000151000000 DICOMI I COMMUNICATIONS ADDRESS 
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i9§92 
• t 
02 

03 

04 
05 

06 
07 
08 
09 
10 
U 
12 
13 
14 
IS 
16 
17 
18 
19 
20 

21 
22 
23 
24 
25 
26 
27 
26 
29 
30 
31 
32 
33 
34 
35 
36 
37 



LZCENSED 
OXOEV 



MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 



t INITIALIZE THE DIGITAL INTERFACE 
1 •' — ^^ - 

F INPUTI AC0«nESSAGE ADDRESS 



I CALLING SEQUENCEI 



000161084016 DIDEFI 

00017*040776 

00020*020774 

000211024757 

000221006017 

000231021007 

000241001400 

000251060142 

000261001401 



JSR OIDEF 
<ERROR RETURN* 
<NORMAL RETURN* 

STA 3 USP 

STA DICOM 
LDA DCODE 
LDA I DIDCT 
.SrSTM 
.lOEF 
JMP 3 
NIOS 010 
JMP 1 3 



f DEVICE CODE (DIO) ALREADY IN USE 

I SAVE COMMUNICATIONS ADDRESS 

I ATTACH TO RODS INTERRUPT SYSTEM 

t ERROR RETURN 

I ARM THE EXTERNAL INTERRUPT 

I NORMAL RETURN 



I DETACH THE INTERRUPT SERVICING ROUTINE & CLEAR DEVICE 
I *.......^. ........:.... 

I CALLING SEQUENCES 



000271054016 DICLRS 

00030>060242 

00031*020763 

00032*006017 

00033*021010 

00034*001400 

00035*001400 



JSR OICLR 
<NORMAL RETURN* 

STA 3 USP 
NIOC DIO 
LDA OCOOE 
.SYSTh 
,IRMV 
JMP 3 
JMP 3 



f CLEAR DIO DEVICE 
I DETACH HANDLER 
I NORMAL RETURN 
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38 
39 
40 
41 
42 
43 

44 00036 

45 00037 

46 00040 
47 

48 00041 

49 00042 

90 00043 

91 00044 

92 0004d 

93 00046 

94 00047 
99 00050 
96 00091 
97 

98 000S2 

99 00053 



(064542 

112501^9 
1001400 

'054412 
•050410 
1102400 
>042751 
1020750 
•177777 
'000401 
•030402 
•002402 

1000000 
•000000 



; DIGITAL INTERFACE EXTERNAL INTERRUPT HANDLER 

I ^ - — — 

I input; AC2PDCT ADDRESS 
I 



AC3iINTEHRUPT DISMISSAL ADDRESS 



DINTSI 



DIAS 1 DID 
MOV 1 1 SNR 
JMP 3 

STA 3 DISMISS 

STA 2 SAVE2 

SUB 

STA #0ICOM 

LDA DICOM 

.IXMT 

JMP .^l 

LDA 2 SAVE2 

JMP #DISMISS 



SAVE2t 
DISMISSI 



1 READ 16 BIT REGISTER 

; VALUE ZERO ? 

I YES--DISMISS INTERRUPT 

I NO--SAVE DISMISSAL ROUTINE ADDRESS 

I SAVE AC2 ALSO 

; CLEAR SIGNAL ADDRESS 

I GET SIGNAL ADDRESS 

; WAKE UP USER TASK 

f RESTORE AC2 

I DISMISS THE INTERRUPT 

I TEMPORARY STORAGE FOR AC2 

t INTERRUPT DISMISSAL ADDRESS 



.END 



LICENSED 
0003 DZDEV 


MATERIAL 


m PROPERTY OF DATA GENERAL CORPORATION 


DCODE 000014 




1/30 


2/14 


2/31 


DICLR 000027< 


EN 


1/09 


2/29 




DICOM 000015< 




1/31 


2/13 


2/51 2/52 


DIDCT 0000001 




1/20 


2/15 




OIDEP 0000161 


EN 


1/09 


2/12 




DINTS 0000361 




1/24 


2/44 




DISAV 0000041 




1/22 


1/29 




OISMZ 0000531 




2/48 


2/56 


2/99 


8AVE2 0000521 




2/49 


2/55 


2/58 


U8DCT 0000011 




1/20 


1/22 




•IXMT 0000461 


%H 


1/11 


2/53 
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Licensed Material - Property of Data General Corporation 

Multiprocessor Communications Adapter 

RDOS revisions 03 and higher extend system support to option 4038, the multi- 
processor communications adapter (MCA). Nonetheless, the MCA can be treated 
as a user-defined device. The following program illustrates such an MCA driver 
and illustrates the . STMAP call which is required when running data channel devices 
in the user area on a mapped system. 

Page 1 of die listing illustrates the MCA receiver and transmitter DCT's, RUSDCT 
and TUSDCT. These DCT's are standard user DCT's; note that bit zero is set to 
one. This is required when the devices are identified to the system in subroutine 
M[DEF, since they are data channel devices used in a mapped system. 

The MCA handler must be initialized before use, and this is done by a user call to 
MIDEF illustrated on page 5 of the listing. This routine identifies both the trans- 
mitter and receiver to the system and defines the number of 1024^0 word blocks 
which will be required for data channel transfers (two blocks each for transmissions 
and receptions). Additionally, this routine converts the logical buffer addresses, 
input to the initialization call, to physical addresses required for data channel 
transfers in mapped machines (lines 34-43). That is, whenever a user program sets 
aside a series of logical locations as a data channel buffer, .STMAP returns the 
actual address assignments made by the mapping unit. All addresses in mapped 
user programs are logical, since the user program is unaware of the actual 
locations assigned by the hardware; the actual address assignements, however, 
must be sent to data channel devices. Beyond sending these addresses to the data 
channel devices, the user program need not be concerned with the actual address 
assignments. 

Since MIDEF identifies the MCA units to the system only once, MIDEF can be 
invoked by the user whenever different read/write buffers are to be used. 

The read and write subroutines proper are found on listing pages 2 and 3. Each of 
these routines first checks to see if the device is busy; if so, the error return is 
taken. Otherwise, each routine outputs the word count and logical starting address 
to its device, and the transmit routine also outputs the receiver number to the 
transmitter. Then each routine waits, via a call to .REC, until its associated 
interrupt processor (page 4 of the listing) readies it via an interrupt message call, 
. IXMT, indicating tliat the process is complete. The read/write routine then 
resets its busy flag and takes the call's normal return. 
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0001 MCAOR MACRO REV 02 li:i2;24 12/18/73 

01 
02 

0d 

04 ; MULTIPROCESSOR COMMUNICATIONS ADAPTER (TYPE 4038) 

05 ; —.—...—.... — . — ^....... .................... 

06 ; — *. .... .... .. 

07 

.TITLE MCADR ; MCA DRIVER 
09 

10 .ENT MCARD MCAWT MIOEF 

11 

12 ,tXTN ,IXMT,,KEC 

13 

14 .NREL 

15 

16 I DEVICE CONTROL TABLE LAYOUT 

17 ; 

18 

19 0000M'100002'MRDCT: Ib0+RUSDCT ; ADDRESS OP MCA RECEIVER OCT 

20 00001»100005»MTDCTI 1B04.TUSDCT t ADDRESS OF MCA TRANSMITTER D 
21 

22 00002'000012*RUSOCTI MSAVE I INTERRUPT STATE SAVE AREA 

23 00003*000010 1812 t MASK MORD 

24 000041000101 I RINTS ; INTERRUPT ROUTINE ADDRESS 
25 

26 00005'000012'TUSuCT: MSAVE f INTERRUPT STATE SAVE AREA 

27 00006*000010 1812 f MASK WORD 

28 00007»000106« TINTS ; INTERRUPT ROUTINE ADDRESS 
29 

30 t ADDITIONAL VARIABLES FOR MCA DRIVER 

31 } 

32 

33 000101000007 RCOOEt MCAR f RECEIVER DEVICE CODE 

34 0001P000006 TCODEJ MCAT t TRANSMITTER DEVICE CODE 

35 00012>000010 MSAVEt ,BLK 10 t STATE SAVE AREA 
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1006)2 MCADR 
01 
02 f MCA READ SUBROUTINE 



03 f *,,..........,.....-« 

04 

05 I INPUTI* 

06 t AC0aMORD COUNT 
07 

08 1 CALLING SEOUENCES- 

09 t JSR MCARO 

10 I <ERROR RETURN> f HANDLER ALREADY ACTIVE 
U I <NORMAL RETURN> 

12 

13 1 OUTPUTt* 

U t AClaMCA STATUS WORD 

15 

16 00022»030420 MCARDJ LOA 2 RBUSY f PICKUP STATUS FLAG 

17 00023'151004 MQV 2 2 SZR I CHECK IT 

18 00024'00M422 JMP RERTN ; DEVICE BUSY 

19 00025>010415 ISZ RBUSY 1 SET ROUTINE BUSY 

20 00026«050416 STA 2 RSIGLtl ; RESET DONE SISGNAL 

21 00027«054412 STA 3 RRTN t SAVE RETURN ADDRESS 

22 00030*062007 008 MCAR ; SEND WORD COUNT TO RECEIVER 

23 0003l'0244l4 LDA 1 RADDR ; PICK UP LOGICAL STARTING ADDRESS 

24 00032'a65l07 DOAS I MCAR f SEND STARTING ADDRESS 

25 00033»020410 LOA RSIGL t WAIT FOR OPERATION COMPLETE FLAG 

26 000341177777 ,REC 

27 00035'102400 SUB 

28 00036'040404 STA RBUSY f RESET RECEIVER BUSY FLAG 

29 00037>010402 ISZ RRTN 

30 000401002401 JMP PRRTN t TAKE NORMAL RETURN 

31 

32 000411000000 RRTNI 

39 00042'000001 RBUSY2 1 
34 

35 00043*000044'RSIGL: *«1 

36 000441000001 .BLK 1 
37 

3b 00045'000000 RADDRI ; RECEIVER BUFFER LOGICAL ADDRESS 

39 t AS DEFINED BY .STMAP SYSTEM CALL 

40 ; DURING DEVICE INITIALIZATION , 

41 

42 00046«030402 RERTN: LDA 2 RDVBSY I DEVICE ALREADY BUSY 

43 00047'001400 JMP 3 t PROCESSING A PREVIOUS CALL 

45 00050'00M047 ROVBSY: ERSIM I SIMULTANEOUS READS OR WRITES NOT ALLOW 
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10003 MC 

01 

02 

03 

04 
05 
06 
07 

08 

09 

1ft! 

11 

12 

13 

14 

15 

16 

17 00051 

16 00052 

19 00053 

20 00054 

21 00055 

22 00056 

23 00057 

24 00060 

25 00061 

26 00062 

27 00063 

28 00064 

29 00065 

30 00066 

31 00067 

32 00070 

33 00071 

34 00072 
35 

36 00073 

37 00074 
38 

39 00075 

40 00076 
41 

42 Id<dld77 

43 

44 

45 

46 

47 

48 

49 00100 



LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
ADR 



MCA WRITE SUBROUTINE 



INPUT 



AC0>WORO COUNT 

AClsRECElVER NUMBER IN BITS 0-3 (1-17(8)) 



CALLING SEQUENCEI- 
JSR MCAWT 
<ERROR RETURN> 
<NORMAL RETURN> 

OUTPUTI- 



AClaMCA STATUS WORD FOR TRANSMITTER 



030423 MCAWT: 

151004 

000773 

010420 

044423 

050420 

054414 

062006 

024416 

065006 

030415 

073106 

020410 

00id034i 

102400 

040404 

010402 

002401 

000000 trtn: 

000001 leusYi 

000076'TSIGL: 
000001 



LDA 2 TBUSY 
MOV 2 2 SZR 
JMP TERTN 
ISZ TBUSY 
STA I RECDV 
STA 2 TSIGL+1 
STA 3 TRTN 
DOB MCAT 
LDA 1 TAODR 
DOA 1 MCAT 
LDA 2 RECDV 
DOCS 2 MCAT 
LDA TSIGL 
,REC 
SUB 
STA TBUSY 
ISZ TRTN 
JMP #TRTN 


1 

.♦I 
.BLK 1 



t PICKUP STATUS FLAG 

1 CHECK IT 

; ALREADY ACTIVE - ERROR RETURN 

? INDICATE DEVICE IS BUSY 

; SAVE RECEIVER NUMBER 

; RESET TRANSMITTER DONE SIGNAL 

» SAVE RETURN ADDRESS 

t PICKUP LOGICAL STARTING ADDRESS 



; WAIT FOR OPERATION COMPLETE 

f RESET TRANSMITTER BUSY FLAG 
J TAKE NORMAL RETURN TO USER 



1000000 taddr: 



; TRANSMITTER BUFFER LOGICAL ADDRESS 
t AS DEFINED BY .STMAP SYSTEM CALL 
f DURING DEVICE INITIALIZATION , 



000046'TERTNa RERTN f TRANSMITTER BUSY ERROR RETURN 



'000000 RECOVS 00 



; RECEIVER DEVICE NUMBER 
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I00ld4 HCAOR 
01 

02 J MCA RECEIVER INTERRUPT PROCESSOR 

03 ; -,-..-——,—.-—.—«- 

04 

05 00101 '066607 RINTSS OICC I MCAR t CLEAR RECEI VER/KEAD STATUS 

06 001021020741 LDA RSIGL f GET SIGNAL ADURESS 

07 001031177777 .IXMT 

06 001041000406 JMP DISMISS 

09 00105I00040S JMP DISMISS 
10 

11 ; MCA TRANSMITTER INTERRUPT PROCESSOR 

12 I 

13 

14 00106>066606 tints: DICC 1 MCAT J CLEAR TRANSMITTER/READ STATUS 

15 00107'020766 LDA TSIGL ; GET SIGNAL ADDRESS 

16 0011010001031 .UMT 

17 00111'00to401 JMP .♦I 

16 00112I0304&)2 DISMISS: LDA 2 USCDE ; GET DISMISS CODE 

19 00113<060202 NIOC MAP ; TRIGGER THE MMPU 
20 

21 00114'000003 DSCOE: 03 J CODE FOR DISMISSING THE INTERRUPT 

22 ; UNDER A NOVA 840 SYSTEM 
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10005 

01 

02 

03 

04 

05 

06 

07 

08 

09 

10 

11 

12 

13 

14 

15 

16 

17 

lb 

\y 

20 
21 
22 
23 
24 
25 
26 
27 
26 
29 
30 
31 
32 
33 
34 
35 
36 
37 
36 
39 
40 
41 
42 
43 
44 
45 
46 
47 
46 
49 
50 
51 
52 
53 



LICENSED 
MCAOR 



00 

00 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 



115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 
135 
136 
137 
140 
141 
142 
143 
144 
145 
146 
147 
150 
151 
152 
153 



00154 



00 
00 



155 
156 



054437 

040724 
044755 
010435 
000414 
020666 
024655 
030432 
006017 
021007 
002425 
020661 
024650 
006017 
021007 
002420 
054420 
020652 
024703 
006017 
021035 
002412 
044702 
020645 
024727 
006017 
021035 
002404 
044726 
010402 
002401 



MATEKIAL • PROPERTY OF DATA GENERAL CORPORATION 



INITIALIZE THE MCA HANDLER 



INPUTS- 

AC0»STARTIN& CORE 
ACl-STARTING CORE 

CALLING SEQUENCE:- 
JSR MIOEF 
<ERROR RETURN> 
<NORMAL RETURN> 



MIDEF: 



MACTV: 



177777 

000002 



HCATVJ 
C2I 



STA 
STA 

STA 
ISZ 
JMP 
LDA 
LQA 
LDA 
.SYST 
,IDtF 
JMP # 
LDA 
LDA 1 
.SYST 
,1DEF 
JMP # 
STA 3 
LDA 
LDA 1 
.SYST 
.STMA 
JMP $ 
STA 1 
LDA 
LDA 1 
.5YST 
.STMA 
JMP # 
STA 1 
ISZ M 
JMP # 



MIRTN 
RBUSY 
TBUSY 

CATV 

ACTV 
RCODE 
MRDCT 
C2 

M 

MIRTN 
TCODE 
MTDCT 

M 

MIRTN 
MCATV 
RCODE 
RbUSY 

M 

P 

MIRTN 
RADDR 
TCODE 
TbUSY 

H 

P 

MIRTN 
TADDR 

IRTN 

MIRTN 



000000 MIRTNt 



-1 
2 

• END 



ADDRESS 
ADDRESS 



OF RECEIVER BUFFER 
OF TRANSMITTER BUFFER 



SAVE RETURN ADDRESS 

SAVE USER BUFFER ADDRESSES 

DEVICE ALREADY INTRODUCED TO SYSTEM? 
YES, JUST GET LOGICAL ADDRESSES 
RECEIVER DEVICE CODE 
RECEIVER DEVICE CONTROL TABLE 
NUMBER OF IK BLOCKS 
DEFINE DEVICE TO SYSTEM 



TAKE ERROR RETURN 
TRANSMITTER DEVICE CODE 
TRANSMITTER DEVICE CONTROL 
DEFINE DEVICE TO SYSTEM 



TAKE ERROR RETURN 
SET ACTIVE FLAG 
GET DEVICE CODE 
USER BUFFER ADDRESS 
GET LOGICAL ADDRESS 



TABLE 



OF BUFFER 



TAKE ERROR RETURN 
SAVE LOGICAL ADDRESS 
DEVICE CODE 
GET BUFFER ADDRESS 
GET LOGICAL ADDRESS OF 



USER BUFFER 



TAKE ERROR RETURN 

SAVE LOGICAL ADDRESS OF TRANSMITTER B 

NORMAL RETURN 

RETURN ADDRESS 



MCA DEVICE ACTIVE FLAG 

NUMBER OF 1024 WORD BLOCKS FOR MCA 
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LICENSED MATERIAL 

eiaee mcaor 



• PROPERTY OF DATA GENERAL CORPORATION 



C2 

DISMI 

DSCDE 

MACTV 

HCARD 

MCATV 

MCAWT 

MIDEF 

MIRTN 

MROCT 

M5AVE 

MTOCT 

RAODR 

RBUSY 

RCODE 

RDVBS 

RECDV 

RERTN 

RINTS 

RRTN 

RSIGL 

RUSDC 

TAODR 

TBU5Y 

TCODE 

TERTN 

TINTS 

TRTN 

TSIGL 

TUSDC 

,IXMT 

.REC 



000156 
000112 

000114 
000135 
000022 
000155 
000051 
000115 
000154 

000000 
000012 
000001 
000045 
000042 
000010 
000050 
000100 
000046 
000101 
000041 
000043 
000002 
ddm77 
000074 
000011 
000t(fl46 
000106 
000073 
000075 

000005 
000110 

00006b 



EN 

EN 
EN 



XN 
XN 



5/22 
4/08 
4/18 
5/19 
1/10 
5/18 
1/10 
1/10 
5/15 
5/47 
1/19 
1/22 
1/20 
2/23 
2/16 
1/33 
2/42 
3/21 
2/18 
1/24 
2/21 
2/20 
1/19 
3/25 
3/17 
1/34 
3/19 
1/28 
3/23 
3/22 
1/20 
1/12 
1/12 



5/51 
4/09 
4/21 
5/31 
2/16 
5/31 
3/17 
5/15 
5/25 

5/21 
1/26 
5/27 
2/38 
2/19 
5/20 
2/45 
3/27 
2/42 
4/05 
2/29 
2/25 
1/22 
3/42 
3/20 
5/26 
3/46 
4/14 
3/33 
3/29 
1/26 
4/07 
2/2b 



4/18 



5/50 



5/30 



1/35 

5/37 
2/28 
5/32 

3/49 
3/46 

2/30 
2/35 

5/43 
3/32 
5/3b 



3/34 
3/39 

4/16 
3/30 



5/36 



5/42 



5/44 



5/45 



2/33 



5/16 



5/33 



2/32 
4/06 



3/37 



3/36 
4/15 



5/17 



5/39 






3-26 



INDEX 



AGO 2-4f* 

ACl 2-4f 

AC2 2-4f 

ACHR 2-31f 

AGSUB 2-5. 2-7ff 

analog to digital converter 3-lOff 

beads 2-16ff 
BGSUB 2-5, 2-7ff 

cassette 2-1 

$CDR/$CDR1 1-3,2-1, 2-7,2-18f, 3-7 

CLEAR 2-9,2-12 

CLSl 2-21 

CLSO 2-21 

CMPWD 2-9, 2-1 Iff 

COSER 2-27,2-31 

CSP 2-5ff 



DC 2-16ff 


DCHMP 


1-11 


DCHNM 


1-11 


DCCRQ 


1-10 


DCDST 


1-10 


DCNBK 


1-10 


DCNBl 


1-10 


DCSTR 


1-10 


DL'i'BC 


1-8 


DCi'BD 


1-9 


DCTB? 


1-8 


DCTBS 


1-7,3-1 


DCi'CC 


1-9 


DCTCD 


1-8 


DCTCH 


1-7 


DC'i'DC 


1-9 


DCi'DP 


1-9 


DC'i'DT 


1-8, 2-19f 


DCTEX 


1-8 


DCTIN 


1-10 


DCTIS 


1-7,3-1 


DCl'LC 


1-9 


DCTLK 


1-9 


*Note: '1 


" means ' an 



1-10 

1-7,3-1 

1-10 

1-10 

1-9 

1-9 

1-9 

1-8 

1-9 

1-9 

1-9 

1-9,2-17 

1-9 

1-10 

1-10 

1-10 

1-10 

1-9 

1-8 

1-10 

1-9,2-30 

1-9 

1-9 

1-9 

2-27f 

2-28 

device codes 2 -If 

Device Control Table (DCT) l-5f,2-3, 
2-32, 3-15, 3-17, 3-20f 
digital interface driver (4066) 3-l6ff 
disk l-3f,l-10f.2-l,3-7 
DISMIS 1 -6 
dispatch table 2-20ff 
DIVD 2-9,2-13 
DIVI 2-9,2-13 
DP 2-l6ff 
$DPO/$DPI 1-3,2-1 
.DUCLK 3-8f 

ENQUE 2-18,2-27 



DCTMN 

DCTMS 

DCTNH 

DCTNS 

DCTOF 

DCTON 

DCTOP 

DCTPC 

DCTPP 

DCTPR 

DCTQL 

DCTQP 

DCTQS 

DCTRD 

DCTRL 

DCTRN 

DCTRS 

DCTSL 

DCTST 

DCTSZ 

DCTTO 

DCTTl 

DCTT2 

DCTT3 

DEQRQ 

DEQUE 



and the following page'; 'ff means ' and the following pages. ' 



INDEX -1 



frame pointer 2-6 
frame sizes 1-10 

GDIRS 2-24f 
GMDIR 2-24f 
GSUB 2-5, 2-7ff 

IBUF 2-16ff. 2-29, 2-31 
. IDEF 2-1, 3-2f, 3-7, 3-10, 3-13, 3-18, 

3-25 
INTO 1-4,1-6 
INTS 1-6 

lOBUF 2-25ff, 2-30 
IPB 1 -3 

.IRMV 3-4,3-13,3-18 
ITBL l-5ff, 3-1 
.IXMT 3-2, 3-16f,3-19f. 3-24 

LDBT 2-9 
LDCHR 2-9 
$LPT/$LFn 2-1,3-7 

magnetic tape 2 -2 
mask 1-3,1-6 
MBLK 2-9 
MBMVW 2-9, 2-14f 
MCA l-3,2-lf,3-20ff 
MCLR 2-9,2-12,2-15 
MGSUB 2-5,2-7ff 
MFMVB 2-9,2-13f 
MFMVW 2-9r2H^ 
MLfDBT 2-9,2-14 
MF^ 2-9 
MPYAD 2-9 
MSTBT 2-9,2-11,2-14 
MTMVB 2-9,2-13f 
MTMVW .2-9,2-14f" 
MVBYT ?-9,2-ll 
MVMFW 2-7 
MVWD 2-7,2-9,2-13f 
MXTMP 2-4f 

NMAX 1-11 



OAQi 2-5ff,2-39 
OBUF 2-l6ff,2-30 
OPNI 2-20 
OPNO 2-20 
ORTN 2-5ff 
OSP 2-6f 
OVRTN 2-6f 

PARS 2t5,2-10 

PARU 1-11,2-30 

PC 2-16ff 

PENQU 2-29 

$PLT/$PLT1 l-3f,2-2 

power fail service 3-6ff 

PP 2-16ff 

$PTP/$PTP1 1-3,2-2,3-7 

$PTR/$PTR1 l-3,2-2,2-19,2-39ff,3-7 

QTY 1-3,2-2,3-7 

quad multiplexer (see QTY) 



RCHR 


2-30ff 




RDL 


2-20,2- 


30f,2-38 


RDS : 


2-21f,2- 


■30f 


.REC 


3-20,3 


-22f 


RETN 


2-8ff 




RINGl 


2-7,2 


-15ff 


RING2 


2-7,2- 


15ff 


RING3 


2-15ff 




ROX 


2-9f,2-: 


12 



RSAVE 2-6,2-9ff 

RSTFL 2-9,2-13 

RTC 2-2 

RTLOC 2-4f 

RTN 2-5f 

RTRN 2-6,2-ll,2-30,2-38f 

. RUCLK 3-9f 

SAV 2-5 
SAVE 2-6,2-38 
SETFL 2-9,2-13 
SFTAB 2-33 
.SMSK 3-2,3-6 
SP 2-4 
SRTN 2-5f,2-9f 



INDEX -2 



UFTUN 


1-12 




UFTYD 


1-12 




.UIEX 


3-2, 3- 


•4 


.UPEX 


3-2, 3 


-8 



SRTRN 2-6,2-11 

stack frames 2-4 

STBT 2-9, 2-11 

STCHR 2^,2-11 

.STMAP 3-5,3-20,3-25 User File Table (UFT) l-llf,2-20ff,2-38 

STOUT 2 -27 user interrupts Chapter 3 

SYS.DR 2-2f 

system generation (SYSGEN) 2-3, 2-37f 

system library 2-3,2-35ff VCT 1-4 

system queue 2-3,2-37 VRTN 2-4f 

system stacks 2-3ff 

WRL 2-23f 
Teletype or console l-3f,2-2,2-18 WRS 2-23 

TMP 2-4,2-6f 

XIBUF 2-29f 



.UCEX 


3-9f 


UFCAl 


1-12 


UFD 1- 


■11 


UFEAl 


1-12 


UFFAl 


1-12 


UFLAN 


1-12 


UFLAl 


1-12 


UFNAl 


1-12 


UFTAC 


1-12 


UFTAD 


1-12 


UFTAT 


1-12 


UFTBC 


1-12 


UFl'BK 


1-12 


UFTCA 


1-12 


UFTCB 


1-12 


UFTDC 


1-12 


UFTDL 


1-12 


UFTDR 


1-12 


UFTEA 


1-12 


UFTEX 


1-12 


UFTFA 


1-12 


UFTFN 


1-12 


UFi'HM 


1-12 


UFT LA 


1-12 


UFTLK 


1-12 


UFTNA 


1-12 


UFiTl 


1-12 


UFTP2 


1-12 


UFTST 


1-12 


UFl'UC 


1-12 
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Ir DalaGeneral 

Software Documentatioit Remarks Form 



How Do You Like This Manual? 



litle. 



No.. 



We wrote the book for you, and naturally we had to make certain assumptions about who you are and how you 
would use it. Your comments will help us correct our assumptions and improve our manuals. Please take a few 
minutes to respond. 

If you have any comments on the software itself, please contact your Data General representative If you wish to 
order manuals, consult the Publications Catalog (01 2-330). 



Who Are You? 






lanuali 



'3 EDP Manager 

n Senior System Analyst 

11 Analyst/Programmer 

D Operator 

n Other 



(List III order: I = Primary mc) 

Introduction to the product 

Reference 

Tutorial Text 

Operating Guide 



What programming language(s) do you use? 



Do You Like The Manual? 



Yes Somtwhat No 
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Is the manual easy to read? 

Is it easy to understand? 

Is the topic order easy to follow? 

Is the technical information accurate? 

Can you easily find what you want? 

Do the illustrations help you? 

Does the manual tell you everything you need to know' 



Conw^nts? 
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< l"case note pane number and paragraph where applicable.) 
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